From owner-freebsd-doc@freebsd.org  Fri Feb  5 22:55:14 2021
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id CB77452C36D
 for <freebsd-doc@mailman.nyi.freebsd.org>;
 Fri,  5 Feb 2021 22:55:14 +0000 (UTC)
 (envelope-from brooks@spindle.one-eyed-alien.net)
Received: from spindle.one-eyed-alien.net (spindle.one-eyed-alien.net
 [199.48.129.229])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 4DXW365G2zz4fG6;
 Fri,  5 Feb 2021 22:55:14 +0000 (UTC)
 (envelope-from brooks@spindle.one-eyed-alien.net)
Received: by spindle.one-eyed-alien.net (Postfix, from userid 3001)
 id 4EE5A3C0199; Fri,  5 Feb 2021 22:55:08 +0000 (UTC)
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>
References: <1c54f0c2-c5fd-b266-a760-ae4c374a7e84@FreeBSD.org>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
 protocol="application/pgp-signature"; boundary="0OAP2g/MAC+5xKAE"
Content-Disposition: inline
In-Reply-To: <1c54f0c2-c5fd-b266-a760-ae4c374a7e84@FreeBSD.org>
User-Agent: Mutt/1.9.4 (2018-02-28)
X-Rspamd-Queue-Id: 4DXW365G2zz4fG6
X-Spamd-Bar: ----
Authentication-Results: mx1.freebsd.org;
	none
X-Spamd-Result: default: False [-4.00 / 15.00];
	 REPLY(-4.00)[]
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 05 Feb 2021 22:55:14 -0000


--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--