Markdoc
Markdoc
Markdoc is a Markdown-based authoring framework created by Stripe. It extends Markdown with a custom syntax for tags, attributes, and functions — designed for building documentation sites where you need more power than plain Markdown but want to keep content readable.
Stripe built Markdoc to power their own documentation and open-sourced it in 2022.
Key features
- Extends Markdown rather than replacing it — valid Markdown is valid Markdoc
- Custom tags for components like callouts, tabs, conditional content
- Variables and functions for dynamic content
- Built-in validation to catch errors in content at build time
- Framework-agnostic rendering (React, HTML, etc.)
When to use it
Markdoc is a good fit when you need more than plain Markdown (e.g. interactive components, conditional content) but want to keep content accessible to non-developers. It's an alternative to MDX that avoids mixing JSX into Markdown files.
