And another update (2015-01-12)
This is a follow up the previous article about using markdown for XML2RFC. The syntax has been changed and more features have been implement. And my blackfriday fork has been renamed mmark.
See this document for an up to date syntax of mmark. A short summery will be given here.
New features are:
- Include raw XML references
- Allow HTML comments to be converted to
- Abbreviations (https://michelf.ca/projects/php-markdown/extra/#abbr), this is not used in XML2RFC but seems a relatively standard markdown extension
- Example lists (http://johnmacfarlane.net/pandoc/README.html#numbered-example-lists)
- Quote attribution
Also the possibility to convert pandoc2rfc documents to mmark has been added (as a quick and dirty perl script + pandoc!):
For example converting the middle section from some other draft:
% pandoc --atx-headers -t markdown_phpextra < ~/i-d/nsec4/middle.mkd |\ ./parts.pl | tee part.md
For a first pass for getting a (non) perfect title block you could use
Syntax has been changed slightly.
Use the reference syntax:
[@RFC2535 p. 23].
They can optionally have ‘!’ or ‘?’ modifier to normative or informative reference. The
reference section is automatically generated. Here is a normative and informative reference:
The default is informative. This only have to be done once, after that you can just use
And an even shorter syntax has been added, just
@RFC2535, works once a citation has been defined.
Start the section with the special header syntax
.#. The section’s name must be
insensitive). (Colophon and friends might be added as well).
Notes and Asides
Asides is created with prefixing each line of a paragraph with
Using triple parentheses, like so:
(((Cats, Tiger))). You can now only add a primary
!: (((!Cats, Tiger))).
-# as a header to start a new part.
$$ is detected and anything inside is math. If an entire paragraph consists out of
math, display mode is used.