Re:Don’t Use Markdown for Documentation (2016)
by tgp on Sunday February 18, 2018 @11:44PM
(#16410806)
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...
[ Parent
| on HN ]
There are no comments on this comment yet.