Is here common source format to produce mdoc and MarkDown?

Brooks Davis brooks at freebsd.org
Fri Feb 5 22:55:14 UTC 2021


On Sat, Feb 06, 2021 at 01:42:26AM +0300, Lev Serebryakov wrote:
> 
>   I understand, that my question is not about FreeBSD documentation exactly, but close enough. If I'm not right, sorry.
> 
>   I want to have both proper man page in mdoc format and fancy README in MarkDown for github & ko for my project. Content of these documents must be virtually the same and I don't want to edit same text twice in different formats each time when I want to change it.
> 
>   Is here any source format to render both MarkDown and mdoc?
> 
>   I understand, that mdoc is semantic format (it has "options" and "arguments" and such), and MarkDown is not...
> 
>   Maybe, mdoc to MarkDown converter? It is not best way, as mdoc is very tedious to edit, but better than nothing.

See mandoc(1) and -T markdown.  No idea if it's any good.

-- Brooks
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 455 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20210205/8a8aebab/attachment.sig>


More information about the freebsd-doc mailing list