
Markdoc
Markdown-based syntax and toolchain for building custom documentation sites, with a parser, a transform step and renderers.
Markdoc is a Markdown syntax and a JavaScript toolchain for building documentation sites. Content goes through three steps: parse turns the source into a tree, transform turns the tree into renderable content, and a renderer produces HTML or React output. Authors can add their own tags and nodes, and the library has built-in validation for checking content before it renders.
Stripe created Markdoc for its own documentation. The repository also holds a Next.js integration, a separate package that builds a documentation site from Markdoc content.
Worth knowing
The React renderer needs React installed, and the public renderer types need @types/react even when only the parser or the HTML renderer is used.
Identity
Rendering and deploy
- Install with
- npm3
Releases
Adoption
Sources
- 2026-11-16: links, Owned by
markdoc.dev/ - 2026-11-16: links, Written in, License model, GitHub stars
github.com/markdoc/markdoc - 2026-11-16: links, Install with
markdoc.dev/docs - 2026-11-16: Maintainer, Maintained by, License
github.com/markdoc/markdoc/blob/main/LICENSE - 2026-11-16: Categories
github.com/markdoc/markdoc/blob/main/README.md - 2026-11-16: Current major version
github.com/markdoc/markdoc/releases/tag/v0.5.12 - 2026-11-16: Last release
registry.npmjs.org/@markdoc/markdoc - 2026-11-16: First release
github.com/markdoc/markdoc/releases/tag/0.1.0 - 2026-11-16: npm downloads a week
api.npmjs.org/downloads/range/2026-11-01:2026-11-07/@markdoc/markdoc - 2026-11-16: Contributors
api.github.com/repos/markdoc/markdoc/contributors?per_page=1 - 2026-11-16: Dependent packages, Dependent repositories
packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/@markdoc%2Fmarkdoc