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.

Upload a DESIGN.md and see your brand guideline rendered instantly.Open the tool