Mermaid-first
Validates lang=mermaid code blocks via @mermaid-js/parser. Diagram
syntax errors surface inline, before they reach your docs site.
crackdown
Fast, extensible Markdown linting with first-class Mermaid diagram validation.
Why crackdown?
Built on unified/remark
Uses the mdast AST pipeline — position-aware, composable, and compatible with 300+ existing remark plugins.
markdownlint compatible
Drop-in bridge for .markdownlintrc configs. Run crackdown migrate to
generate a crackdown.config.ts from your existing setup in seconds.
Auto-fix built in
crackdown lint --fix applies safe mechanical fixers (trailing spaces, hard
tabs). --dry-run shows what would change without touching files.