Re: Generating markdown output from DocBook

Deannelson <[email protected]> Wed, 27 Jan 2021 03:08:28 +0000 (UTC)
Newsgroups gmane.text.docbook.apps
Message-ID <[email protected]>
Peter To go from DocBook to MD, I do something like:pandoc -f docbook -t markdown_github 2.xml -o 2.md and back is: pandoc -s -t docbook -f markdown_github 2.md -o 2-out.xml warning: I have not used this in a few years, so you mileage may vary. Regards,Dean Nelson In a message dated 1/26/2021 6:11:46 PM Pacific Standard Time, [email protected] writes: 
I'm finding that more documentation tools are optimized for consuming markdown these days. For example, some commercial API portal frameworks 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