markdoc/markdoc

Health v2 · maintenance only

Adoption not part of the score

8414 stars · 250 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Markdoc is a Markdown-based authoring framework and toolchain created by Stripe, extending CommonMark with custom tags, annotations, and variables. It parses documents into an AST, transforms them into a renderable tree, and renders to HTML or React components for building documentation sites and interactive content experiences.

Use cases

• build a custom documentation site with markdown
• render markdown with custom React components
• add conditionals and variables to markdown content
• validate markdown content in CI
• create interactive docs like Stripe's documentation
• convert markdown to HTML or React trees

When to choose

• you need structured, interactive documentation beyond plain Markdown
• you want to embed React components in Markdown content
• you need programmatic validation and static analysis of content
• you want a declarative authoring format with full control over rendering

When to avoid

• you just need simple Markdown-to-HTML conversion
• you want a batteries-included static site generator with zero setup
• your project doesn't use JavaScript or React

Facets

library · maturity stable

parser templating static-site-generator documentation markdown documentation web-development frontend developer-tools cross-platform markdown-framework authoring react-renderer content-publishing stripe nodejs web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="markdoc/markdoc")