Date: Fri, 5 Feb 2021 22:55:08 +0000 From: Brooks Davis <brooks@freebsd.org> To: Lev Serebryakov <lev@FreeBSD.org> Cc: freebsd-doc@freebsd.org Subject: Re: Is here common source format to produce mdoc and MarkDown? Message-ID: <20210205225508.GA56641@spindle.one-eyed-alien.net> In-Reply-To: <1c54f0c2-c5fd-b266-a760-ae4c374a7e84@FreeBSD.org>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] 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 [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- iQEcBAEBAgAGBQJgHczLAAoJEKzQXbSebgfAIWAH/RVGuIL43nU11ySwjCgaiG6+ jt3Zj8AU53VuP/SA3YCKwO4IyOt8eHuHEFLS6FxzxJtvdo0w91qBleviSU4bIv59 NafEHaYh0YtS1y7rChZCf+UEjvK3hfyzqQftEAGGmFzq4fPDdiiP7JhPRuHYiz2h BxMPEk+8SpojvivGUWrQbYeJRFqTDR6QT0xLACZ6dtmnC2gU9vLagjRQI625p4Ih QaZ1hIqp8PDMP2z7PRgq2a0M64SlOkjWlG1+J3iz5jybYyUeOqDCnSYEB5tx+fBK QIGVmS6EmxRCWdstOyeQiT4NEsYXoCTxVBz4f/0p5b+vvL8OKtldefIDzwwSzuE= =cmRf -----END PGP SIGNATURE-----home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210205225508.GA56641>