BlogsStripeInteractive Documentation with Markdoc

Interactive Documentation with Markdoc

Interactive Documentation with Markdoc

1
posts
2022

This feature thread tracks Stripe's development of Markdoc, a custom templating language and static site generator, to build interactive and maintainable documentation. The initial post introduces Markdoc as a solution for creating rich documentation experiences that blend static content with dynamic elements, improving both the authoring and reading experience for developers. It details how Markdoc allows for the expression of interactivity and page logic without mixing code and content, enabling a more robust and engaging documentation platform.

2022

How Stripe builds interactive docs with Markdoc

9/13/2022

This post introduces Markdoc, a custom templating language and static site generator developed by Stripe, to build interactive documentation. It highlights how Markdoc enables writers to express interactivity and simple page logic without mixing code and content, delivering a good user experience without compromising the authoring experience. The post emphasizes the technical approach to creating rich documentation experiences that blend static content with dynamic elements.