- Fix MD040 (11 bare fences): add language tags (text/bash) across 7 files - Fix MD031 (2 violations): add blank lines around fence in GETTING-STARTED.md - Wire 'Markdown lint' step to fast-checks job (after Format check, before Typecheck) - Reformat .markdownlint-cli2.jsonc per Prettier (trailing commas in JSONC) - pnpm md:lint exits 0; pnpm format:check exits 0; gate can fail on bare fence (verified)
24 lines
1.1 KiB
JSON
24 lines
1.1 KiB
JSON
// .markdownlint-cli2.jsonc
|
|
{
|
|
"config": {
|
|
// Disable all rules that conflict with Prettier (23 rules — line-length, list-indent,
|
|
// blanks-around-fences, emphasis-style, etc.)
|
|
"extends": "markdownlint/style/prettier",
|
|
|
|
// Content rules to KEEP:
|
|
"MD001": true, // heading-increment: no skipping h1→h3
|
|
"MD024": true, // no-duplicate-heading
|
|
"MD040": true, // fenced-code-language: all fences must declare a language
|
|
"MD031": true, // blanks-around-fences (re-enabled — see Pitfall 4 in RESEARCH.md)
|
|
"MD051": true, // link-fragments: broken anchor links
|
|
"MD052": true, // reference-links-images: undefined link references
|
|
|
|
// Rules DISABLED (Prettier owns these OR they fire on non-author-controlled files):
|
|
"MD041": false, // first-line-h1: CLAUDE.md legitimately starts with ## Project
|
|
"MD034": false, // no-bare-urls: CLAUDE.md version table uses pkg@version syntax
|
|
"MD036": false, // no-emphasis-as-heading: docs/API.md uses **Response 200** as label
|
|
},
|
|
"globs": ["docs/**/*.md", "*.md", "apps/**/*.md"],
|
|
"ignores": [".planning/**", "node_modules/**", "**/node_modules/**", ".pnpm-store/**"],
|
|
}
|