[apps-discuss] text/markdown draft-03 guide (and use-cases-00 guide)

[Sean Leonard <[e-mail]>]

The following documents are about to be posted:

draft-ietf-appsawg-text-markdown-03
draft-seantek-text-markdown-use-cases-00

As discussed in the last couple of posts: 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).

draft-ietf-appsawg-text-markdown-03
   1. Introduction
   2. Markdown Media Type Registration Application
   3.  Optional Parameters
     3.1. syntax
     3.2. output-type
   4. Fragment Identifiers
   5.  Example


draft-seantek-text-markdown-use-cases-00
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,

Sean