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> References: <1c54f0c2-c5fd-b266-a760-ae4c374a7e84@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--0OAP2g/MAC+5xKAE Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Feb 06, 2021 at 01:42:26AM +0300, Lev Serebryakov wrote: >=20 > I understand, that my question is not about FreeBSD documentation exact= ly, but close enough. If I'm not right, sorry. >=20 > 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 f= ormats each time when I want to change it. >=20 > Is here any source format to render both MarkDown and mdoc? >=20 > I understand, that mdoc is semantic format (it has "options" and "argum= ents" and such), and MarkDown is not... >=20 > 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 --0OAP2g/MAC+5xKAE Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQEcBAEBAgAGBQJgHczLAAoJEKzQXbSebgfAIWAH/RVGuIL43nU11ySwjCgaiG6+ jt3Zj8AU53VuP/SA3YCKwO4IyOt8eHuHEFLS6FxzxJtvdo0w91qBleviSU4bIv59 NafEHaYh0YtS1y7rChZCf+UEjvK3hfyzqQftEAGGmFzq4fPDdiiP7JhPRuHYiz2h BxMPEk+8SpojvivGUWrQbYeJRFqTDR6QT0xLACZ6dtmnC2gU9vLagjRQI625p4Ih QaZ1hIqp8PDMP2z7PRgq2a0M64SlOkjWlG1+J3iz5jybYyUeOqDCnSYEB5tx+fBK QIGVmS6EmxRCWdstOyeQiT4NEsYXoCTxVBz4f/0p5b+vvL8OKtldefIDzwwSzuE= =cmRf -----END PGP SIGNATURE----- --0OAP2g/MAC+5xKAE--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210205225508.GA56641>