Two years of Markdoc: what we’ve learned about balancing developer and author experience




At Write the Docs Portland in 2020, we described how we built Markdoc—an extensible Markdown-based content format—to enable application-like user experiences in our documentation while providing a low-friction authoring experience.

Two years later, Markdoc now powers thousands of pages of documentation at Stripe and is available to the community under a permissive open source license. We are back to discuss what we’ve learned about using Markdoc in practice, how we balance developer experience (DX) with authoring experience (AX), Markdoc’s burgeoning open source community, and ideas for what you can start building with Markdoc today.

In this talk, we’ll:

  • Discuss common authoring pain points when hundreds of cross-functional stakeholders contribute to documentation
  • Uncover some tips, tooling, and strategies for solving these problems
  • Showcase inspiring examples of Markdoc in the wild
  • Conference: Write the Docs Prague
  • Year: 2022

About the speaker

Ryan Paul