IETF Logo Mail Archive

Re: [Ietf-and-github] Create .md file

"STARK, BARBARA H" <bs7652@att.com> Mon, 20 September 2021 18:34 UTC

Return-Path: <bs7652@att.com>
X-Original-To: ietf-and-github@ietfa.amsl.com
Delivered-To: ietf-and-github@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4C90D3A110B for <ietf-and-github@ietfa.amsl.com>; Mon, 20 Sep 2021 11:34:46 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.799
X-Spam-Level:
X-Spam-Status: No, score=-1.799 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=att.onmicrosoft.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id a1jLu9sVs4sf for <ietf-and-github@ietfa.amsl.com>; Mon, 20 Sep 2021 11:34:41 -0700 (PDT)
Received: from mx0a-00191d01.pphosted.com (mx0b-00191d01.pphosted.com [67.231.157.136]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 758683A1111 for <ietf-and-github@ietfa.amsl.com>; Mon, 20 Sep 2021 11:34:40 -0700 (PDT)
Received: from pps.filterd (m0049463.ppops.net [127.0.0.1]) by m0049463.ppops.net-00191d01. (8.16.0.43/8.16.0.43) with SMTP id 18KIOKk3024113; Mon, 20 Sep 2021 14:34:34 -0400
Received: from alpi155.enaf.aldc.att.com (sbcsmtp7.sbc.com [144.160.229.24]) by m0049463.ppops.net-00191d01. with ESMTP id 3b5wqccve5-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 20 Sep 2021 14:34:33 -0400
Received: from enaf.aldc.att.com (localhost [127.0.0.1]) by alpi155.enaf.aldc.att.com (8.14.5/8.14.5) with ESMTP id 18KIYWge009051; Mon, 20 Sep 2021 14:34:33 -0400
Received: from zlp27129.vci.att.com (zlp27129.vci.att.com [135.66.87.42]) by alpi155.enaf.aldc.att.com (8.14.5/8.14.5) with ESMTP id 18KIYOiv008780 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Mon, 20 Sep 2021 14:34:25 -0400
Received: from zlp27129.vci.att.com (zlp27129.vci.att.com [127.0.0.1]) by zlp27129.vci.att.com (Service) with ESMTP id D4E4B401C844; Mon, 20 Sep 2021 18:34:24 +0000 (GMT)
Received: from MISOUT7MSGEX2AE.ITServices.sbc.com (unknown [135.66.184.192]) by zlp27129.vci.att.com (Service) with ESMTP id B71B7401C843; Mon, 20 Sep 2021 18:34:24 +0000 (GMT)
Received: from MISOUT7MSGED1DA.ITServices.sbc.com (135.66.184.175) by MISOUT7MSGEX2AE.ITServices.sbc.com (135.66.184.192) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.14; Mon, 20 Sep 2021 14:34:24 -0400
Received: from MISOUT7MSGETA01.tmg.ad.att.com (144.160.12.221) by MISOUT7MSGED1DA.ITServices.sbc.com (135.66.184.175) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.14 via Frontend Transport; Mon, 20 Sep 2021 14:34:24 -0400
Received: from NAM12-MW2-obe.outbound.protection.outlook.com (104.47.66.48) by edgeso1.exch.att.com (144.160.12.221) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2308.14; Mon, 20 Sep 2021 14:34:14 -0400
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=I8ONbI2bK/inNRqfR82ZTyyLC6iL3bpfrceFrCIbXJrhUFWyN49Id943TYIBuW/ETFcv8cgAD1qCySBRpwDkphHMfZAAjM4FhDthD0eqZhr9oBrvO6eCvcPIz8I3+fh6EN+Yimiv6YzHa8epiXD7AHEd0yoyyUjI/jJdkFV7+FQd+qtPQVCFaUWXOWYYIZqiY3cxRVYKCbuCRSjg3v/fQnERn5gSudCx/xm6AkkTBkqpFssuac/6AhnxeGO2rzQSv+QZ8wJrMaUQ+BsIgqHtEIEagHlCaHajp8oOiI9V+BTQaaISzAuwbK2I57F1isLjIV/ptMeEbhUIRQe+4ShVqA==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=TLtp6v0XXBRj314bbuahLKrR06tbnFJOdwUoYz2YP54=; b=Xr8q1ogSZ4Bp39M0zWhDkfM9vtd9cJ+4ipTKh1SHoRZBPe62m4R0VhfGMjACfglHSg5Yw1x+cBkAQnqO5XuFPozk10NzoZN2ceTAWwY+fYhskywbnIjsu+IC207ZJEBEIaJPosGgPpTvs65r237dZb7croj1hOZ5dGWhJ1wjiy06EQ/JT6HUGN9NekCCHxHMfF2jaflthZFsySUKYJBzYLeTjtuD82M0xmg70+N9fv3sYaauEllnYiC2axMjpUkbE6TbwKvd6ck0B5mG54w5z/doX4T3VgtN0Tt34o9IhiYWXl4pFTX7vYQYrm2dBhxONYuNKdCyc/KqLFnJkEvVbw==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=att.com; dmarc=pass action=none header.from=att.com; dkim=pass header.d=att.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=att.onmicrosoft.com; s=selector2-att-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=TLtp6v0XXBRj314bbuahLKrR06tbnFJOdwUoYz2YP54=; b=NWpLOyKrkRkpfktB4loVbFql+/njBP1rFP7p/vBHv33F/Rf2fY2WSYmSi410NSAajtYiqf2a4jnNmiV6VhbLLlBjprbMBy2xkziJ98escUxWY/Ate9Jc3cTSY/T2anTFmRpLI5WwFCvkU5vZ5Re3HrfBTj5A68u92RtDJF1LS+M=
Received: from DM6PR02MB6924.namprd02.prod.outlook.com (2603:10b6:5:25f::7) by DM5PR0201MB3589.namprd02.prod.outlook.com (2603:10b6:4:80::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4523.14; Mon, 20 Sep 2021 18:34:12 +0000
Received: from DM6PR02MB6924.namprd02.prod.outlook.com ([fe80::ddec:9436:4971:5d1e]) by DM6PR02MB6924.namprd02.prod.outlook.com ([fe80::ddec:9436:4971:5d1e%4]) with mapi id 15.20.4523.018; Mon, 20 Sep 2021 18:34:12 +0000
From: "STARK, BARBARA H" <bs7652@att.com>
To: 'Richard Barnes' <rlb@ipv.sx>, 'Carsten Bormann' <cabo@tzi.org>
CC: "'ietf-and-github@ietfa.amsl.com'" <ietf-and-github@ietfa.amsl.com>, "'sarikaya@ieee.org'" <sarikaya@ieee.org>
Thread-Topic: [Ietf-and-github] Create .md file
Thread-Index: AQHXrALnArTVJ9eKnUObC7C5cx++cKuotF+AgAR+lACAAA/x4A==
Date: Mon, 20 Sep 2021 18:34:12 +0000
Message-ID: <DM6PR02MB69241AB202BEC2A0C5AB901AC3A09@DM6PR02MB6924.namprd02.prod.outlook.com>
References: <CAC8QAcddjyR_q7AX8YqyLq8-4Au16HoHOv+_qk5Kd5YmqVFc+A@mail.gmail.com> <769E39EF-4DE1-4C4F-BEE4-EEA070C5B586@tzi.org> <CAL02cgR995jkD-gjQg6xZP6ArpOF79sf9N3FoLXvSmb97ayuGw@mail.gmail.com>
In-Reply-To: <CAL02cgR995jkD-gjQg6xZP6ArpOF79sf9N3FoLXvSmb97ayuGw@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: ipv.sx; dkim=none (message not signed) header.d=none;ipv.sx; dmarc=none action=none header.from=att.com;
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 84089082-c46b-4d84-dbd3-08d97c653e25
x-ms-traffictypediagnostic: DM5PR0201MB3589:
x-microsoft-antispam-prvs: <DM5PR0201MB3589EA6AC000407FBF73BD59C3A09@DM5PR0201MB3589.namprd02.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:1728;
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: Gb0wDLhm1jSCCvffUxAIWZEe1fp8+C9zYbPCW5/eMwEJXaJFNK82LSJTW3iIqxb4eeqsTB8pogb9BIX/YRqojffew3ICjuH20Z02oMx5FvNYbXB3q8c3HFuL/2I6jQr3BXdHjoz3WiC11EKaZWGLNeNvD5asKVt/7SuHZjg1h6SiOPxTZVUjKafYdz8zIUMR9vjc3KCV0VBsl+P5P7Zds5JVTLX6z4MfRUCrJr4TdRDEAmWMp5u3/XxWMIeCFSW+xVpD54WM6g7tyKqnP+1KiDT7EJnp00sGs4DWZXrZK6Zrly5lJOMEFgmYMSjTzv1qsrWWjQPl6w1yEjtEQJQCeAofF8Kk3cjsmDj7vKNMxILebN0pHsNx9n1lE/4v/a4gp5L9IzUWdT7O3XXw1fr0MLFGsRhZVKYbonhcvTVygphBBox6XO23rUkHgNX9mQqQIvwve0kN8yHK5G2WsyGJbqAS8YAGXyrrL5dw7rHm3PT0jooNs+5yaNNcoKWydlg+nF8G8wqdidCJVXe70byq4TDTPY5I//M+8WNh/Tu307Hf0If3gpt+O80MVwOTbQkVT9NWNKkPVUh1C1GAS67vrbc0kuu7yx4jYURmXGZHgLH8Ctdw/JHm5uP9CwLmZMBafFafH+rVwzb8AqPJmw2X/pQIa3PqNosqQIQWiAOEOaZY2KoBoqtmNdkukazxI1d1eInGlJbicEogNf3x3ueK2PfWlGRPSXjMKn2BVDvYdtOdij8cP6POXAe8R2kPKpNi8/3oF8cfdjL6xGy68i/xr+8B+BS/Nkl+cf+K4eIxQhO6mzg/N3aXS39QUSNhHEY6Fgsu7AeOVmpA7pRt1T/2UWzNF0dmYZWhk1Qnf8a93Uw=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR02MB6924.namprd02.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(9686003)(316002)(71200400001)(86362001)(66556008)(122000001)(82202003)(26005)(508600001)(2906002)(83380400001)(7696005)(64756008)(5660300002)(38070700005)(966005)(52536014)(6506007)(166002)(66946007)(53546011)(54906003)(110136005)(55016002)(8676002)(38100700002)(33656002)(8936002)(4326008)(76116006)(66476007)(186003)(66446008)(142923001)(579004); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: IE3zTzE7TYSQX47ahcgBS27GXrb/res970KTKADyqSvXSb9Kq/qlsm3f/DwFeZUVTRGh7QPZmDaKrFfBGwdJgA3FTrnHoD6WzK3yzTz6dynxiVr4At6HhnYuQ9Uvckr05F5z1mv/isY6FLjaDHzcq5hD968FVoRXBJBQUt1Hw7ff9RBp24pIBNZEixspzJvll+EcRrt7nDeknXIheAFohW3mQGQpcD8xl0AeXyg3eYZZzeefGUH3nuOmL4KhzhXf/fbSAHUTlJgZI/h2oMU5DQN6oAdeiQTYLpOV/1/JtdA5loL3OfdJVnG7b9RUiyjALhmovIlo1gafPUDeIu+WjK5FznGCGteFPBwPfuEvNi9gi4PK0LRzswHI807pBQvgBxKbF5U45FhsHEaIQUMo/ciWyuiBitZZMTZSP70eb+6F1EFsgmkMC7Dao2ncg0NPOnEfIeMN1xHR7RTtmJo4MftEAyBIX13sc+5c1/x1iXOfOTl7nxA9XNRM4tVErC7QmVSPVzpyRFFGxuio2pbqrFuf0DdjMuB/SeMMJfubi47NCeKpHLPVPyVTxfibhrh3PXI0IpkjBfqlX/3gIAD/YFiyvvsJu/4fy/RbD+l6KI5yWUudTTpjCLIhbfeexNbNb6JIayLoJtKSmAH5KkJ5QxT68udJFerZ7JpyWGqybWnGxH8tn+Mch8Zb67cFYgUKpE1FAXq4Be3h3+ZCt6op1lxCTunrPOnt3sOLPLLbMJqUKrHLstp/ADalza0KY7Ih04jBrnFR3Um7VEO62PZsa1ccpY2GEr4Qa3XqqMqNEn79oqUMZ2nOty3/rWpyTPWJm76B40plggJgdgbwWQOtwgRX0OZ1J3zscKSDZZN3HJo5WCV2cDxuXnDjZM7+afqo2pLgqu6DwP7BtJAGjTQJfc8JeY4hpxRdJWrVm3BVqrnaWgpW+rcDPYtu19MJC/RBeipQKlgEtPyqUReFEBb1GJC8DzYElRnM0+nTcZwxMWKYdgya6DZcDhW0lbwnQRHQvaoepbPNuNDl24giOkImWfH7S1ioj/8D6iy3yWXNmYEXzwZC2IoYEWQrvu2QTNnOVVPzkawjkiXFSxOxIOEzanDpX4ab3FsDt8E9bzv/IbMhErfv06UCndi1syE3xwBnTLGWLLxSOuqK4Py3quhLWQzDJD+WweLBbOcbmxQ9tL0zKQC9OAiNe3vYXyYM9s8T93nb3UAfWaOl2zIhciczDXHSMycrumdFCJ9qO3Ch1Uuht39okP1/TixBM94e9cmECONoyyG9mBpge2efJ0nTXMutG6tCH/XOqs6W89LjNbo=
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_DM6PR02MB69241AB202BEC2A0C5AB901AC3A09DM6PR02MB6924namp_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DM6PR02MB6924.namprd02.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 84089082-c46b-4d84-dbd3-08d97c653e25
X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Sep 2021 18:34:12.4103 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: e741d71c-c6b6-47b0-803c-0f3b32b07556
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: qBI8wgT52mBPV9717WmHhhKjAgdAuq9iL2JLO5A8vLEWOEwTIk6K2eu/BV5Y3CRO
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR0201MB3589
X-OriginatorOrg: att.com
X-TM-SNTS-SMTP: 9FB0D2D008A04A2C14A17B75266D50284EF56D19AE9CD46886BD0871BDC4316C2
X-Proofpoint-GUID: GiHJm2vn5x2c7TTLpDhB465ymrKdYKf6
X-Proofpoint-ORIG-GUID: GiHJm2vn5x2c7TTLpDhB465ymrKdYKf6
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.391, 18.0.790 definitions=2021-09-20_07:2021-09-20, 2021-09-20 signatures=0
X-Proofpoint-Spam-Details: rule=outbound_policy_notspam policy=outbound_policy score=0 clxscore=1011 phishscore=0 suspectscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 mlxlogscore=999 bulkscore=0 malwarescore=0 impostorscore=0 adultscore=0 priorityscore=1501 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2109030001 definitions=main-2109200109
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-and-github/2cn9J1PXMlKyFpgl_G_MnONtPxI>
Subject: Re: [Ietf-and-github] Create .md file
X-BeenThere: ietf-and-github@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion of using GitHub in IETF activities, particularly for Working Groups" <ietf-and-github.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf-and-github>, <mailto:ietf-and-github-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf-and-github/>
List-Post: <mailto:ietf-and-github@ietf.org>
List-Help: <mailto:ietf-and-github-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf-and-github>, <mailto:ietf-and-github-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 20 Sep 2021 18:34:47 -0000

For the YAML headers and "--- abstract" "--- middle" dividers and such, I find Carsten's STuPiD example to be a useful template to copy from or use as a template to paste into.
https://raw.githubusercontent.com/cabo/kramdown-rfc2629/master/examples/stupid-s.mkd

Barbara

From: Ietf-and-github <ietf-and-github-bounces@ietf.org> On Behalf Of Richard Barnes
Sent: Monday, September 20, 2021 12:33 PM
To: Carsten Bormann <cabo@tzi.org>
Cc: ietf-and-github@ietfa.amsl.com; sarikaya@ieee.org
Subject: Re: [Ietf-and-github] Create .md file

If you're starting from .txt, you can hack something basic with a few steps:
1. Annotate headings with an appropriate number of '#' characters.  For instance, "5. Security Considerations" would become "# Security Considerations" and "3.2.4.1. Packet Format" would become "#### Packet Format".
2. Remove leading whitespace `s/^   //`
3. Put `~~~` fences around figures and move captions to `{}` metadata
4. Convert references to MD-friendly ones.  For example, change "[RFC8555]" to "{{!RFC8555}}".

That should get you most of the way.
--RLB

On Fri, Sep 17, 2021 at 4:54 PM Carsten Bormann <cabo@tzi.org<mailto:cabo@tzi.org>> wrote:
On 17. Sep 2021, at 22:29, Behcet Sarikaya <sarikaya2012@gmail.com<mailto:sarikaya2012@gmail.com>> wrote:
>
> Hi all,
>
> Can someone tell me how I can create .md file from my draft .txt (or .xml) file?
> I could not find an answer to this in that places I have been looking so far:)

You can do this manually (there is not really that much different between .txt and .md).
Or you can send me the XML, wait till I'm back from vacation (W39), and I'll let my tool convert that to .md.

Grüße, Carsten


_______________________________________________
Ietf-and-github mailing list
Ietf-and-github@ietf.org<mailto:Ietf-and-github@ietf.org>
https://www.ietf.org/mailman/listinfo/ietf-and-github<https://urldefense.com/v3/__https:/www.ietf.org/mailman/listinfo/ietf-and-github__;!!BhdT!1s3jAc727W3AuTfCO1N_Kz4UpQnHOvorhBIIBGgWGz7P1wvXv36_I0o7rGj5Ww$>

v2.23.0 | Report a Bug | By Email