md-validation
Mermaid Diagrams
Validate Mermaid diagrams render correctly before shipping. Open the HTML artifact in a browser and check every diagram visually — syntax errors show as broken renders, not error messages.
Common failure modes:
- Unquoted labels with punctuation break the parse
- Bare lowercase
endcollides with subgraph terminator - Node IDs starting with
oorxafter edge markers get misparsed - Custom fills without matching text color make labels unreadable
See resources/mermaid-authoring.md for the full authoring rules (quoting,
line breaks, reserved words, themes).
Markdown Links
Check that relative links between pages resolve. When building a multi-page artifact or KB, broken cross-references silently rot — verify each link target exists before committing.