I'm finding that more documentation tools are optimized for consuming
markdown these days. For example, some commercial API portal framework
<https://redoc.ly/docs/developer-portal/organizing-files/>s and
site-generation tools use markdown as their default input formats.

Does anyone have a nice solution for using tools that consume markdown when
you write and maintain your documentation source in DocBook XML format?

I have considered using a utility like Pandoc as a final processing step.
So the chain would be something like DocBook > XSLT > HTML > Pandoc >
markdown.

I have also wondered whether anyone has built DocBook XSLT that directly
converts the XML to markdown.

Do you have something that works well for you?

Thanks!

Peter

Reply via email to