Generating markdown output from DocBook

Peter Desjardins <[email protected]> Tue, 26 Jan 2021 21:11:32 -0500
Newsgroups gmane.text.docbook.apps
Message-ID <CAMmOXbZOf0oe+Shh9ktCFwPVt_rEDvSwaHRD8FH0A3Mu0gkwrA@mail.gmail.com>
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