Comment by tgp

Markdown is fine for small snippets, READMEs, Github comments etc., but I don't think it's suitable for a longer document such as software documentation. After thinking about that problem and exploring options for a while I have come to believe that some lightweight markup that can be converted to DocBook may be the way to go. I have blogged about such a pipeline here: https://nablux.net/tgp/weblog/2017/04/02/lightweight-semanti...