lint-clean-markdownlisted

# Lint-Clean Markdown > Eliminate the edit-lint-fix cycle by writing markdown correctly the first time. ## When to Use - Authoring any markdown file in this brain or in heir documentation - Reviewing a PR that touches `.md` files - The file just hit MD031, MD032, MD022, or MD060 errors ## The Golden Rule **When in doubt: add a blank line.** Roughly 90% of markdown lint errors are missing blank lines. Lists, code blocks, and headings all need breathing room. ## Core Rules Quick Reference | Rule | Code | Pattern | Mnemonic | |------|------|---------|----------| | Blank lines around lists | MD032 | `\n- item\n- item\n` | "Lists breathe" | | Blank lines around fences | MD031 | `\n\`\`\`code\`\`\`\n` | "Code breathes" | | Blank line before headings | MD022 | `text\n\n## Head` | "Headers breathe" | | Use dash for lists | MD004 | `-` not `*` or `+` | "Dash dash dash" | | No trailing whitespace | MD009 | No spaces at line end | "Clean endings" | | Hard line break in prose | (no MD code) | End line with `\` then newline | "Backslash breaks" | | Single final newline | MD047 | One `\n` at EOF | "One newline" | | Language on fences | MD040 | ` ```js ` not ` ``` ` | "Name your code" | | Consistent fence style | MD046 | Use ` ``` ` not indent | "Fences only" | | No bold as heading | MD036 | Use `##` not `**text**` | "Headers are headers" | | Table separator spacing | MD060 | Space around pipes | "Tables breathe too" | ## Rule Details ### MD032: Blank Lines Around Lists ❌ Wrong: