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

From
Deannelson <>
Date
2021-01-27T03:08:33+00:00
ID
Thread
Re: [docbook-apps] Generating markdown output from DocBook
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,  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