6

Markdoc | A powerful, flexible, Markdown-based authoring framework

 1 year ago
source link: https://markdoc.io/?ref=sidebar
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

# Markdoc
Markdoc is
a
{% type

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

View docs

xxxxxxxxxx
---
title: What is Markdoc?
---
# {% $markdoc.frontmatter.title %} {% #overview %}
Markdoc is a Markdown-based syntax and toolchain for creating custom documentation sites. Stripe created Markdoc to power [our public docs](http://stripe.com/docs).
{% callout type="check" %}
Markdoc is open-source—check out its [source](http://github.com/markdoc/markdoc) to see how it works.
{% /callout %}
## How is Markdoc different?
Markdoc uses a fully declarative approach to composition and flow control, where other solutions… [Read more](/docs/overview).
## Next steps
- [Install Markdoc](/docs/getting-started)
- [Explore the syntax](/docs/syntax)

What is Markdoc?

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

Checkmark Circle

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

Open source

Maintain full control over your code and content. Markdoc is open-source and fully extensible.

Developer & writer friendly

Markdoc delivers a powerful, flexible, developer experience (DX) with an equally capable authoring experience (AX).

Adopt anywhere

Use Markdoc to create interactive documentation experiences, static content sites, authoring tooling, and 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

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


About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK