Session
MDX vs. Markdoc: Delighting Users with Interactive Documentation.
In the modern API economy, documentation is the most important “frontend” that SaaS tools can have. Creating a great experience there directly impacts your bottom line growth. And—thanks to modern frontend tooling (and the OpenAPI spec)—building engaging, interactive documentation is an incredibly rewarding experience.
In this session, we’ll dive into MDX and Markdoc, two leading technologies for building interactive docs that create an “app-like” experience for your users. We’ll discuss their benefits and tradeoffs, then look at real-world implementations. I’ll share firsthand insights from large documentation rebuilds done with both tools, what it was like using them in production, and compare the authoring and development experience for both. This session will also touch on the role of OpenAPI and the Docs-like-Code architecture powering this new era of documentation technology.
First time giving the talk but I've led two massive documentation rebuilds over the past couple of years. One was with MDX and the other with Markdoc. So I've got some really neat knowledge to share!
Please note that Sessionize is not responsible for the accuracy or validity of the data provided by speakers. If you suspect this profile to be fake or spam, please let us know.
Jump to top