design-md-validator

# design-md-validator Validate, lint, diff, and export DESIGN.md files using the official Google `@google/design.md` CLI. Always uses the latest published version from npm — no vendored copy, always up-to-date with the spec. --- ## When to Use | Trigger | Action | |---|---| | User has a DESIGN.md file and wants validation | `lint` | | User wants to compare two versions | `diff` | | User wants to export tokens to Tailwind/DTCG | `export` | | User wants to see the current spec | `spec` | | User shares a URL to a raw DESIGN.md | Download locally first | | User asks "is my design.md valid?" | `lint` + interpret findings | --- ## Core Commands All commands use `npx @google/design.md` to ensure the latest version is always used. Never install globally — `npx` resolves from the public npm registry. ### Lint (validate) ```bash npx @google/design.md lint DESIGN.md ``` Output: JSON with `findings[]` and `summary { errors, warnings, infos }`. Exit code 1 if errors found, 0 otherwise. ### Diff (compare versions) ```bash npx @google/design.md diff DESIGN.md DESIGN-v2.md ``` Output: JSON with token-level changes (added, removed, modified) and regression flag. Exit codes: `0` no regression, `1` regression (errors in "after" > errors in "before"), `2` input failure (file not found or unreadable). ### Export (to other formats) ```bash # Tailwind v3 config npx @google/design.md export --format json-tailwind DESIGN.md # Tailwind v4 CSS theme npx @google/design.md export --format...