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