{
    // Sensible defaults for the monorepo. See:
    // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
    "config": {
        "default": true,
        // Long lines are fine in docs that carry code / API refs / paths.
        "MD013": false,
        // Allow HTML (we occasionally need <details>, <br>, <sub>, badges).
        "MD033": false,
        // Allow duplicate headings under different parents (e.g. "Example"
        // appearing in both "Basic Example" and "Advanced Example" trees).
        "MD024": { "siblings_only": true },
        // Bare URLs are fine in changelogs and tables.
        "MD034": false,
        // Allow trailing punctuation in headings (colons etc).
        "MD026": false,
        // Enforce fenced-code language hint so docs stay scannable.
        "MD040": true,
        // Allow **Bold** sub-section dividers inside API/Methods sections —
        // promoting them to real headings would inflate the TOC.
        "MD036": false,
        // Don't insist on a first-line H1 — we occasionally have YAML front
        // matter or status badges before the title.
        "MD041": false
    },
    "globs": ["**/*.md", "**/*.mdx"],
    "ignores": [
        "**/node_modules/**",
        "**/dist/**",
        "**/coverage/**",
        "**/.turbo/**",
        "**/.git/**",
        "**/.remember/**",
        "**/lcov-report/**",
        "**/CHANGELOG.md",
        // Archived openspec changes are frozen historical records.
        "openspec/archive/**",
        // Plan docs embed inline doc stubs with repeated section headings.
        "docs/superpowers/plans/**",
        "docs/superpowers/specs/**",
        // Installed plugin marketplace files are externally managed.
        ".claude/plugins/suaveplan-plugins/**"
    ]
}