Md validation skill
Use when validating markdown links or Mermaid diagrams.
by haowjy·Apache-2.0 license·★ 506 Stars on the repo·GitHub ↗
Use now
npx degit haowjy/creative-writing-skills/cw/skills/md-validation#main ~/.claude/skills/md-validationChecked ·commit main
Files of Md validation
SKILL.md
Show the full text28 lines
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.
| 1 | |
| 2 | name md-validation |
| 3 | description Use when validating markdown links or Mermaid diagrams. |
| 4 | |
| 5 | |
| 6 | # md-validation |
| 7 | |
| 8 | ## Mermaid Diagrams |
| 9 | |
| 10 | Validate Mermaid diagrams render correctly before shipping. Open the HTML |
| 11 | artifact in a browser and check every diagram visually — syntax errors show |
| 12 | as broken renders, not error messages. |
| 13 | |
| 14 | Common failure modes: |
| 15 | Unquoted labels with punctuation break the parse |
| 16 | Bare lowercase `end` collides with subgraph terminator |
| 17 | Node IDs starting with `o` or `x` after edge markers get misparsed |
| 18 | Custom fills without matching text color make labels unreadable |
| 19 | |
| 20 | See `resources/mermaid-authoring.md` for the full authoring rules (quoting, |
| 21 | line breaks, reserved words, themes). |
| 22 | |
| 23 | ## Markdown Links |
| 24 | |
| 25 | Check that relative links between pages resolve. When building a multi-page |
| 26 | artifact or KB, broken cross-references silently rot — verify each link |
| 27 | target exists before committing. |
| 28 |
Discussion
Browse more free Claude skills.