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