text/markdown draft-03 guide (and use-cases-00 guide)

Sean Leonard dev+ietf at seantek.com
Fri Oct 17 19:31:10 EDT 2014

Hello Markdown World:

The following Internet-Drafts are about to be posted:


As discussed in apps-discuss at ietf.org: to make the drafts shorter yet more informative, I split them in two. The secondary document has seven additional syntax registrations, background information, and preservation strategies. The main registration document registers the media type. They are meant to be read together; however, the secondary document makes no normative statements (no RFC 2119 key words).

  1. Introduction
  2. Markdown Media Type Registration Application
  3.  Optional Parameters
    3.1. syntax
    3.2. output-type
  4. Fragment Identifiers
  5.  Example

1. (Introduction)
    1.1. On Formats
    1.2. Markdown Design Philosophy
    1.3. Uses of Markdown
    1.4. Uses of Labeling Markdown Content as text/markdown
  2.  Strategies for Preserving Media Type and Parameters
  3.  Registration Templates for Common Markdown Syntaxes
    3.1. MultiMarkdown
    3.2. GitHub Flavored Markdown
    3.3. Pandoc
    3.4. Fountain (Fountain.io)
    3.5. CommonMark
    3.6. kramdown-rfc2629 (Markdown for RFCs)
    3.7. rfc7328 (Pandoc2rfc)
  4.  Examples for Common Markdown Syntaxes

Thank you,


More information about the Markdown-Discuss mailing list