Authoring
open-docs renders standard Markdown, plus a few extras layered on top via Markdoc: callouts, tabs, screenshots, syntax-highlighted code, and Mermaid diagrams.
You never have to use the extras — a plain .md file with headings, lists, links, and code fences renders beautifully on its own. Reach for the custom blocks when prose alone is not enough.
In this section
Markdown & frontmatter
The basics, and the frontmatter keys that control the sidebar.
Blocks
The rich content blocks: callouts, tabs, steps, cards, and more.
This page is also a live demo
The Blocks entry in the sidebar is a collapsible sub-section, and Media nested inside it goes one level deeper — so the navigation you see here exercises open-docs's folder-derived nesting, up to three levels, with the branch for the page you're on opened automatically.