The DESIGN.md Spec Guide
DESIGN.md is a plain-text file that travels with your code. It holds design tokens in YAML frontmatter and design rationale in Markdown prose. This guide covers every section of the @google/design.md 0.4.0 spec: token types, reference syntax, linting rules, and the canonical section order that validators enforce. New to the format? Start with what DESIGN.md is. Creating your first file? Follow how to create a DESIGN.md file step by step.
Start
Sections
Reference
Lint Rules
Lint Rules OverviewFixing broken-ref in DESIGN.mdFixing missing-primary in DESIGN.mdFixing contrast-ratio in DESIGN.mdThe orphaned-tokens Rule in DESIGN.mdReading token-summary in DESIGN.mdThe missing-sections Rule in DESIGN.mdFixing missing-typography in DESIGN.mdFixing section-order in DESIGN.mdFixing unknown-key in DESIGN.mdFixing token-like-ignored in DESIGN.mdThe omitted Key in DESIGN.md
Upload a DESIGN.md and see your brand guideline rendered instantly.Open the tool