Re:Practical Unix Manuals: mdoc
by nerdponx on Saturday November 25, 2017 @10:17AM
(#15776261)
I'm not sure Markdown->Roff makes sense. I know Pandoc can do it, but how do you convey semantic information with Markdown? I'd sooner write YAML.
[ Parent
| on HN ]
It works, not as good as a good template for LibreOffice though, my point was that the sematics is lost with markdown and you only get formating.
It might not be trendy like Markdown or YAML (both of which I like, and have their uses), but to markup text with higher-level semantics (i.e. not relating to formatting) the best option is XML.
Sure, but do you really want to hand write XML? It's nice for computers but makes for really ugly source when humans are involved, and humans are still very heavily involved when it comes to writing documentation.