.markdownlint-cli2.yaml

# markdownlint-cli2 configuration for fuzzymatch.
#
# Run locally via `markdownlint-cli2 "**/*.md"`; CI runs the markdownlint job
# from .github/workflows/ci.yml using DavidAnson/markdownlint-cli2-action.
# Planning artefacts (.planning/, .claude/) are excluded — they are written
# by tooling and may use formats markdownlint flags.
config:
  MD013: false   # line-length — long URLs and code lines are unavoidable
  MD033: false   # allow inline HTML for badges
  MD041: false   # first line need not be a top-level heading (frontmatter/badges)
  MD024:
    siblings_only: true   # docs/algorithms.md repeats the same H4 subhead per algorithm — that is the point
  MD001: false   # docs/algorithms.md jumps H2 → H4 deliberately to keep the per-algorithm subheads as siblings
  MD060: false   # table-pipe-alignment is too strict for multi-row tables with varied content
  MD051: false   # link-fragments do not handle accented characters (Sørensen-Dice anchor)

globs:
  - "**/*.md"

ignores:
  - "node_modules/**"
  - "vendor/**"
  - ".planning/**"
  - ".claude/**"
  - "tests/bdd/**/vendor/**"
  # REVIEW-FINDINGS.md is a multi-agent audit dump: 6300+ lines, one setext-style
  # H1 per agent, code blocks without language hints, and free-form structure.
  # It is not consumer-facing documentation — it is an audit artefact, like the
  # files under `.planning/`. Treating it as lintable produces ~800 advisories
  # for stylistic choices that are not load-bearing for readers.
  - "REVIEW-FINDINGS.md"
  # CLAUDE.md is local-only guidance for Claude Code (gitignored in some
  # configurations) — internal tooling notes with multiple H1 sections per phase.
  - "CLAUDE.md"
  # docs/prior-art-research.md is a research-notes dump with extensive footnote
  # chains that intentionally cross-reference labels defined elsewhere. The
  # footnote-validity rule does not fit this format.
  - "docs/prior-art-research.md"