https://markdoc.io

Skip to content
 

    DocsGitHubCommunityTwitterTry

Markdoc is a powerful, flexible, Markdown-based authoring framework.

    From personal blogs to massive documentation sites, Markdoc is a
    content authoring system that grows with you.

View docs

Reset
Explore developer sandbox -
Try it out

What is Markdoc?

Markdoc is a Markdown-based syntax and toolchain for creating custom
documentation sites. Stripe created Markdoc to power our public docs.

Markdoc is open-source--check out its source to see how it works.

How is Markdoc different?

Markdoc uses a fully declarative approach to composition and flow
control, where other solutions... Read more.

Next steps

  * Install Markdoc
  * Explore the syntax

Open source          Developer & writer       Adopt anywhere
                     friendly
Maintain full                                 Use Markdoc to create
control over your    Markdoc delivers a       interactive
code and content.    powerful, flexible,      documentation
Markdoc is           developer experience     experiences, static
open-source and      (DX) with an equally     content sites,
fully extensible.    capable authoring        authoring tooling, and
                     experience (AX).         more.

Get started quickly

Markdoc core is a lightweight package containing everything you need
to get started. If you want to get going even faster, check out our
Next.js plugin and deploy a Markdoc documentation site with zero
boilerplate.

Explore documentation

Live edit

npm install @markdoc/markdoc

import Markdoc from '@markdoc/markdoc';

const doc = `
# Hello world.
> My first Markdoc page
`;

const ast = Markdoc.parse(doc);

const content = Markdoc.transform(ast);

const html = Markdoc.renderers.html(content);

Markdoc powers Stripe documentation

Stripe created Markdoc to power its largest and most detailed content
site. Since then, we have adopted it across the company, writing
hundreds of thousands of lines of Markdoc to create thousands of
pages of expressive, custom documentation.

---------------------------------------------------------------------

  * Familiar syntax

    Markdoc is a syntactic extension of Markdown, so you can keep
    using all the syntax and tooling you are used to.

    Learn the syntax

  * Easily extensible

    Markdoc lets you customize all aspects of the system, from custom
    tags and nodes to entirely new renderers.

    Learn more

  * Built-in validation

    You can add custom validation throughout your content system,
    ensuring nothing breaks and your content remains consistent.

    Learn more

CMD + J / Esc

Docs, GitHub, Community, TwitterTry Markdoc

---------------------------------------------------------------------
 
This site was built using Markdoc
Light mode

Docs, GitHub, Community, TwitterTry Markdoc

---------------------------------------------------------------------
 
Light mode
This site was built using Markdoc