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