FindSoftware

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

Status
Active
Maintainer
Stripe, Inc.4
Maintained by
Company4
Owned by
Stripe, Inc.1
First release
20228

Rendering and deploy

Install with
npm3

Releases

Current major version
Pre-1.06
Last release
2026-11-137

Adoption

GitHub stars
8,5252
npm downloads a week
889,0159
Contributors
2510
Dependent repositories
81911
Dependent packages
5511

Why these figures do not compare

Sources

  1. 2026-11-16: links, Owned by
    markdoc.dev/
  2. 2026-11-16: links, Written in, License model, GitHub stars
    github.com/markdoc/markdoc
  3. 2026-11-16: links, Install with
    markdoc.dev/docs
  4. 2026-11-16: Maintainer, Maintained by, License
    github.com/markdoc/markdoc/blob/main/LICENSE
  5. 2026-11-16: Categories
    github.com/markdoc/markdoc/blob/main/README.md
  6. 2026-11-16: Current major version
    github.com/markdoc/markdoc/releases/tag/v0.5.12
  7. 2026-11-16: Last release
    registry.npmjs.org/@markdoc/markdoc
  8. 2026-11-16: First release
    github.com/markdoc/markdoc/releases/tag/0.1.0
  9. 2026-11-16: npm downloads a week
    api.npmjs.org/downloads/range/2026-11-01:2026-11-07/@markdoc/markdoc
  10. 2026-11-16: Contributors
    api.github.com/repos/markdoc/markdoc/contributors?per_page=1
  11. 2026-11-16: Dependent packages, Dependent repositories
    packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/@markdoc%2Fmarkdoc

Last reviewed · Listed since Edit on GitHubThis page as markdownas JSON