# Markdoc

Markdown-based syntax and toolchain for building custom documentation sites, with a parser, a transform step and renderers.


Source: https://findsoftware.frbit.cloud/markdoc/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://markdoc.dev
- repository: https://github.com/markdoc/markdoc
- docs: https://markdoc.dev/docs
- x: https://twitter.com/StripeDev
- forum: https://github.com/markdoc/markdoc/discussions

### Identity

- status: active
- maintainer: Stripe, Inc.
- maintainerType: company
- parent: Stripe, Inc.
- firstRelease: 2022
- hqCountry: unknown

### Kind

- category: library
- hosting: unknown
- language: javascript
- runtime: unknown
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: npm

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 0
- latestReleaseDate: 2026-11-13

### Adoption

- githubStargazers: 8525
- packagistDownloads: not applicable
- npmWeeklyDownloads: 889015
- contributors: 25
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 819
- dependentPackages: 55

### Sources

- urls: https://markdoc.dev/ (read 2026-11-16)
- urls: https://github.com/markdoc/markdoc (read 2026-11-16)
- urls: https://markdoc.dev/docs (read 2026-11-16)
- maintainer: https://github.com/markdoc/markdoc/blob/main/LICENSE (read 2026-11-16)
- maintainerType: https://github.com/markdoc/markdoc/blob/main/LICENSE (read 2026-11-16)
- parent: https://markdoc.dev/ (read 2026-11-16)
- category: https://github.com/markdoc/markdoc/blob/main/README.md (read 2026-11-16)
- language: https://github.com/markdoc/markdoc (read 2026-11-16)
- installMethod: https://markdoc.dev/docs (read 2026-11-16)
- license: https://github.com/markdoc/markdoc/blob/main/LICENSE (read 2026-11-16)
- licenseModel: https://github.com/markdoc/markdoc (read 2026-11-16)
- currentMajor: https://github.com/markdoc/markdoc/releases/tag/v0.5.12 (read 2026-11-16)
- latestReleaseDate: https://registry.npmjs.org/@markdoc/markdoc (read 2026-11-16)
- firstRelease: https://github.com/markdoc/markdoc/releases/tag/0.1.0 (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/@markdoc/markdoc (read 2026-11-16)
- githubStargazers: https://github.com/markdoc/markdoc (read 2026-11-16)
- contributors: https://api.github.com/repos/markdoc/markdoc/contributors?per_page=1 (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/@markdoc%2Fmarkdoc (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/@markdoc%2Fmarkdoc (read 2026-11-16)

## Notes

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.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
