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

[Carsten Bormann <[e-mail]>]

On 2021-07-30, at 02:39, Bob Hinden <[e-mail]> 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


[0]: https://demo.hedgedoc.org/s/yaml-metadata#breaks

(*) 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.).

[1]: https://community.hedgedoc.org/t/should-we-change-the-hedgedoc-default-for-breaks-from-true-to-false/298
Beautiful “vote” in there!