Re: [Tools-discuss] [irsg] [EXTERNAL] Question about Codimd for w.g. minutes

Carsten Bormann <> Fri, 30 July 2021 11:13 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id C08873A268B; Fri, 30 Jul 2021 04:13:58 -0700 (PDT)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: -1.296
X-Spam-Status: No, score=-1.296 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, URIBL_SBL=0.5, URIBL_SBL_A=0.1] autolearn=no autolearn_force=no
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id 7FitpJAhnAZk; Fri, 30 Jul 2021 04:13:53 -0700 (PDT)
Received: from ( []) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPS id 8AD633A2683; Fri, 30 Jul 2021 04:13:53 -0700 (PDT)
Received: from [] ( []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPSA id 4GblC26rxbz31Xm; Fri, 30 Jul 2021 13:13:50 +0200 (CEST)
Content-Type: text/plain; charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.\))
From: Carsten Bormann <>
In-Reply-To: <>
Date: Fri, 30 Jul 2021 13:13:50 +0200
Cc: Robert Sparks <>, Tools Team Discussion <>,
X-Mao-Original-Outgoing-Id: 649336430.505282-e5673245bdf204ac1ef334a82ca765a3
Content-Transfer-Encoding: quoted-printable
Message-Id: <>
References: <> <> <>
To: Bob Hinden <>
X-Mailer: Apple Mail (2.3608.
Archived-At: <>
Subject: Re: [Tools-discuss] [irsg] [EXTERNAL] Question about Codimd for w.g. minutes
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <>
List-Unsubscribe: <>, <>
List-Archive: <>
List-Post: <>
List-Help: <>
List-Subscribe: <>, <>
X-List-Received-Date: Fri, 30 Jul 2021 11:13:59 -0000

On 2021-07-30, at 02:39, Bob Hinden <> wrote:
> I hope we can make sure that the common tools like Codimd and the Datatracker do compatible things.   

I have been informed by a friendly HedgeDoc maintainer (HedgeDoc = independent open-source version of CodiMD) that this is easy to achieve [0].  Just insert

breaks: false

at the start of the CodiMD document and all will be standard(*).

(This also can be set system-wide, but that might break existing documents written without this.)

I’d stick with the CodiMD default `breaks: true`, though, as this is nicer for note-taking; see [1] for the discussion that led to this being the default for hedgedoc.  This is where the de-gfm tool that is now in kramdown-rfc will come in handy.  Or let CodiMD do the HTML conversion, but then there is no standard markdown to put into repos etc.

Grüße, Carsten


(*) note that the docs say

breaks: false

(probably because it’s more pleasingly symmetrical) but that is not standard YAML, so I recommend the three-dot version (which is also the one accepted in kramdown-rfc documents.).

Beautiful “vote” in there!