Re:Mdoc(7) – semantic markup language for formatting manual ...
by JadeNB on Thursday March 09, 2017 @06:27PM
(#13834856)
I think that it's less about YAML, and more about the capability to offer semantic annotation. See, for example, brynet's post (https://news.ycombinator.com/item?id=13834037).
I use POD to write man pages, which is a widely supported, reasonably lightweight markup that generates nice looking man pages. (Example: https://raw.githubusercontent.com/libguestfs/nbdkit/master/d... )