Re: [Tools-discuss] what version of markdown for IETF?

[Michael Richardson <[e-mail]>]

Carsten Bormann <[e-mail]> wrote:
    > Revision is a word that can be used to describe steps in an orderly,
    > linear editing process.  I don’t know how that word got into the same
    > mail as the word markdown…

Sorry, I should have used the word "version" here.
I wrote the email while charing a meeting.

    > Tables weren’t part of the original markdown spec.  This was quickly
    > fixed in the then dominant PHP markdown implementation (the name of
    > which I forget), but other tools have implemented deviant versions of
    > that.  Most notorious is github, which requires all-pipe vertical lines
    > for detection (no plus signs as with everyone else).  John Gruber
    > abandoned markdown, and commonmark came a bit late.  The rest is
    > history.

    > I don’t think we should try to be the guy that cleans up all the kids’
    > rooms in the whole neighborhood.

I'm just thinking that codimd.ietf.org and datatracker.ietf.org (and our new
wiki) should use compatible versions, whichever we think is best.

    >> I know that markdown has many flavours/versions. I have no idea how to
    >> name them.
    >>
    >> Comparing:
    >> https://datatracker.ietf.org/doc/agenda-interim-2021-cellar-06-cellar-01/
    >>
    >> and: https://codimd.ietf.org/notes-ietf-interim-2021-cellar-06-cellar
    >>
    >> you'll see that our nice table is not rendered as such on the DT.

    > Because the thing isn’t rendering markdown at all!

I also clicked on the "markdown" link in the datatracker, btw, and I thought
that it did render it.  I just copied the wrong thing into email:

https://datatracker.ietf.org/meeting/interim-2021-cellar-06/materials/agenda-interim-2021-cellar-06-cellar-01-01.md

--
Michael Richardson <[e-mail]>   . o O ( IPv6 IøT consulting )
           Sandelman Software Works Inc, Ottawa and Worldwide