# Md Validation

> Use when validating markdown links or Mermaid diagrams.

- Skill: `haowjy/md-validation-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add haowjy/md-validation-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haowjy/md-validation-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: haowjy (https://skillmd.com/u/haowjy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/haowjy/md-validation-2

---


# md-validation

Meridian's markdown validation commands work on any markdown file or directory.

## Commands

- **`meridian kg check [path]`**: broken-link gate. Exit `0` clean, `1` broken
  links. Run before committing doc changes.
- **`meridian kg graph [path]`**: link topology visualization. Use to understand
  doc structure and find orphan pages.
- **`meridian kg [path]`**: quick stats (file count, link count, broken count).

Context aliases work as path: `kb`, `strategy`, `work` resolve to their
context directories (e.g. `meridian kg check kb`, `meridian kg graph strategy`).
- **`meridian mermaid check [path]`**: Mermaid diagram validation (syntax +
  style warnings). Run after diagram edits.

## Validation Flow

1. `meridian kg [path]`: quick sanity check
2. `meridian kg check [path]`: catch broken links
3. `meridian mermaid check [path]`: validate diagrams
4. Fix issues and re-run until exit codes are clean

Use `meridian kg --help` and `meridian mermaid --help` for full flag coverage.

See `resources/mermaid-authoring.md` for diagram authoring rules (quoting,
line breaks, reserved words, themes).
See `resources/command-reference.md` for detailed flags and warning categories.