Re: [docbook-apps] Generating markdown output from DocBook

[Deannelson <deannelson@aol.com>]

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, peter.desjardins.us@gmail.com 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