Interactive Docs with Markdoc
I've always loved Stripe's interactive documentation, wondered how they did it and hoped they'd open-source it. I totally missed the news that they did back in May.<p>Now, it seems that 99% of documentation tooling advertised is Markdown based; and e-v-e-r-y time I see this on HN I wonder why AsciiDoc[0] isn't more prevalent than Markdown.<p>AsciiDoc is older than Markdown and out of the box supports things that Markdown doesn't, which has led to a proliferation of Markdown flavors that remind me the web browser experience of the 2000s.<p>It is Stripe's documentation that led me a few years back to look into replicating their documentation, particularly the interactive part of it. While I wasn't able to find any tool out there that did this out the box, that's how I found about AsciiDoc in the first place, and then Antora.<p>This tool, Antora[1], is based on Asciidoc and allows you to create amazing documentation websites. A while back I experimented and wrote a PoC of a plugin for Antora that made my documentation interactive.<p>I also believe that AsciiDoc is what O'Reilly authors use to write books (edit: it is one of 3 languages they [2]use: AsciiDoc, HTMLBook, or DocBook XML)<p>I wish AsciiDoc was more commonly used.<p>[0]: <a href="https://asciidoc.org/" rel="nofollow">https://asciidoc.org/</a><p>[1]: <a href="https://antora.org/" rel="nofollow">https://antora.org/</a><p>[2]: <a href="https://docs.atlas.oreilly.com/index.html#what-is-atlas-DNIRua" rel="nofollow">https://docs.atlas.oreilly.com/index.html#what-is-atlas-DNIR...</a>