Markdoc
ELI5 — The Vibe Check
Markdoc is Stripe's documentation framework that's like MDX's more disciplined cousin. Instead of letting you go wild with JSX, it uses a tag-based syntax that's safer and more structured. It's Markdown with guardrails — content authors can use custom components without accidentally breaking the page with bad JavaScript.
Real Talk
Markdoc is a Markdown-based authoring framework developed by Stripe that extends Markdown with a custom tag syntax for embedding components. Unlike MDX, it doesn't allow arbitrary JavaScript, making it safer for non-developer content authors. It features a validation system, transformable AST, and framework-agnostic rendering.
When You'll Hear This
"We chose Markdoc over MDX because our content team isn't comfortable with JSX." / "Markdoc's validation catches broken tags before they reach production."
Related Terms
Documentation
Documentation is written explanation of how your code works and why.
Markdown
Markdown is a simple way to format text using just plain characters. Put `**asterisks**` around a word and it becomes **bold**.
MDX
MDX is what happens when Markdown and JSX have a baby — you can write your blog post in Markdown but drop in interactive React components wherever you want