3 ms·
Is there some issue with writing your documentation in markdown and pandoc-ing it to the roff format? It's what I do for all my personal man pages and it works
by Spivak 2y ago
Is there some issue with writing your documentation in markdown and pandoc-ing it to the roff format? It's what I do for all my personal man pages and it works fine.
- __mharrison__ 2y agoIs there some issue with pandoc-ing man files to the HTML format? (It's not what I do, I use man from the terminal, but I understand after teaching thousands that terminal mastery is not common.)
- bregma 2y agoYes. Markdown is semantics-free. The man macro set in roff is semantic in nature. There is no bijection. If you're writing semantic-free man pages you're already doing it wrong.