Write specifications with MDX, frontmatter, and a clear page tree.
Authoring covers the basics of writing a spec page: the MDX you write, the frontmatter that describes the page, and how pages are organized into groups and a navigable tree.
In this group
MDX Basics
Markdown plus components for rich, readable specs.
Spec Frontmatter and Icons
Page metadata: title, description, icon, and labels.
Spec Tree and Groups
Organize pages into groups and control navigation.
Authoring principles
- Write the content first; add structure and components second.
- Keep one clear purpose per page.
- Anchor pages to the model with embeds and links.
Consistent frontmatter and tidy groups make the sidebar predictable, which is what readers rely on most.
Last updated on