Stripe designed its product docs to be interactive and customized for each user, which improved the user experience but posed challenges for authors.
- To address this, Stripe created a custom authoring format, Markdoc, which extends Markdown with custom syntax for features like conditional content, content inclusion, and variable interpolation.
- Markdoc keeps the design simple and familiar by adding a few composable primitives, and eliminates looping and variable assignment to ensure content maintainability.
- Markdoc integrates with React for rendering, allowing authors to focus on writing content while designers and engineers can build new components.
