{ "globs": [ "*.md", "crates/**/*.md", "deploy/**/*.md", "docs/**/*.md", "docs/**/*.mdx", "e2e/**/*.md", "examples/**/*.md", "rfc/**/*.md" ], "gitignore": false, "ignores": [ ".agents/**", ".claude/**", ".opencode/**", ".github/**", "plans/**", "architecture/plans/**", "**/node_modules/**", "target/**", ".pytest_cache/**", "THIRD-PARTY-NOTICES/**", "CLAUDE.md", // Man page sources use pandoc markdown with multiple H1 sections // (NAME, SYNOPSIS, DESCRIPTION, etc.) which is standard for man // pages but violates MD025. "deploy/man/**" ], "config": { "default": true, // Allow long lines — prose paragraphs are single-line per project style. "MD013": false, // Allow GitHub-rendered HTML commonly used in READMEs (centered logos, // collapsible sections, keyboard hints). Regular prose HTML still flagged. "MD033": { "allowed_elements": ["p", "img", "br", "a", "div", "details", "summary", "kbd", "sub", "sup"] }, // Allow duplicate headings in different sections. "MD024": { "siblings_only": true }, // Bare URLs are fine in changelogs and tables. "MD034": false, // Internal docs commonly use bare fences for diagrams and terminal sketches. "MD040": false, // First line does not need to be a heading. "MD002": false, // Repo uses padded table pipes (`| foo | bar |`); rule default is "compact". "MD060": { "style": "padded" } } }