Hacker News new | ask | show | jobs
by tgp 3049 days ago
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...