Docs for design.md, Markdown, and MDX
Short guides for teams using Markdown files as portable design context. Start with design.md, then compare plain Markdown and MDX for documentation, agents, and design-system workflows.
Articles
Answer-first guides
Each page targets one search intent with a direct answer, examples, internal links, and structured data for search and answer engines.
Definition
What is a design.md?
Learn what a design.md contains, why Markdown is useful for design systems, and how agents use it as implementation context.
Read guideDefinition
What Is MDX? Markdown + JSX Explained
A concise answer-first guide to MDX, including syntax, build requirements, use cases, and common tradeoffs.
Read guideDeveloper guide
Free design.md API and CLI: Extract design.md from a URL
Use hosted keyless extraction with JSON, Markdown, or MDX outputs, plus purchased AI runs and Docker/self-hosted environment keys for private AI enrichment.
Read guideComparison
Markdown vs MDX: Differences and When to Use Each
Compare Markdown and MDX side by side, including portability, syntax, tooling, design docs, and interactive documentation.
Read guide