[Rfc-markdown] Markdown syntax for rfcs

[Miek Gieben <[e-mail]>]

[ This was sent to rfc-interest, but now that we have our own list, I'm
   resending it here]

Hello,

I'm pondering a markdown syntax (mostly like CommonMark, but with a set of
extensions) for use when writing I-Ds for the XML2RFC v3 format. It steals
syntax from CommonMark, pandoc, kramdown, leanpub and Asciidoc.

To play with it I've forked[1] blackfriday (a markdown converter written in
Golang), and implemented the following:

* TOML titleblock
* including other markdown files with the syntax: {{file}} (and maybe
     <<{{file}}} for including code (also from leanpub syntax)
* indices with the syntax: (((Item, Subitem)))
* main-, middle- and backmatter document divisions, syntax: {mainmatter}, etc.
* citations, syntax: [@RFC223], allows to specify normative/informative and
     reference file
* reference section automatically created
* abstract, prefix paragraph with 'AB>'
* asides, prefix paragraph with 'A>'
* figures, prefix parageaph with 'F>'
* IAL, inline attribute lists from kramdown

It is a work-in-progress and the converter even still outputs some LaTeX blurbs.

I am also pondering a name change from blackfriday to something else, possibly
mmark, to make it clear it isn't blackfriday anymore.

I'm keeping an eye out for RFC 7328 for keeping this syntax backward compatible.

*And* and will create a short document along the lines of draft-hoffman-xml2rfc
that will show the markdown constructs to use.

A short example document can be found here:
https://raw.githubusercontent.com/miekg/blackfriday/master/ietf/ietf-markdown.md

Feedback welcome.

/Miek

[1]: https://github.com/miekg/blackfriday

--
Miek Gieben