draft-ietf-appsawg-text-markdown-11.txt   draft-ietf-appsawg-text-markdown-12.txt 
Applications Area Working Group S. Leonard Applications Area Working Group S. Leonard
Internet-Draft Penango, Inc. Internet-Draft Penango, Inc.
Intended Status: Informational September 3, 2015 Intended Status: Informational October 17, 2015
Expires: March 6, 2016 Expires: April 19, 2016
The text/markdown Media Type The text/markdown Media Type
draft-ietf-appsawg-text-markdown-11 draft-ietf-appsawg-text-markdown-12
Abstract Abstract
This document registers the text/markdown media type for use with This document registers the text/markdown media type for use with
Markdown, a family of plain text formatting syntaxes that optionally Markdown, a family of plain text formatting syntaxes that optionally
can be converted to formal markup languages such as HTML. can be converted to formal markup languages such as HTML.
Status of this Memo Status of this Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
skipping to change at page 2, line 19 skipping to change at page 2, line 19
1.2. Markdown Is About Writing and Editing . . . . . . . . . . . 3 1.2. Markdown Is About Writing and Editing . . . . . . . . . . . 3
1.3. Definitions . . . . . . . . . . . . . . . . . . . . . . . . 5 1.3. Definitions . . . . . . . . . . . . . . . . . . . . . . . . 5
2. Markdown Media Type Registration Application . . . . . . . . . 5 2. Markdown Media Type Registration Application . . . . . . . . . 5
3. Fragment Identifiers . . . . . . . . . . . . . . . . . . . . . 8 3. Fragment Identifiers . . . . . . . . . . . . . . . . . . . . . 8
3.1. Parameters . . . . . . . . . . . . . . . . . . . . . . . . 8 3.1. Parameters . . . . . . . . . . . . . . . . . . . . . . . . 8
4. Content Disposition and preview-type . . . . . . . . . . . . . 8 4. Content Disposition and preview-type . . . . . . . . . . . . . 8
5. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 5. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 10 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 10
6.1. Markdown Variants . . . . . . . . . . . . . . . . . . . . . 10 6.1. Markdown Variants . . . . . . . . . . . . . . . . . . . . . 10
7. Security Considerations . . . . . . . . . . . . . . . . . . . . 12 7. Security Considerations . . . . . . . . . . . . . . . . . . . . 12
8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 13 8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 12
8.1. Normative References . . . . . . . . . . . . . . . . . . . 13 8.1. Normative References . . . . . . . . . . . . . . . . . . . 13
8.2. Informative References . . . . . . . . . . . . . . . . . . 14 8.2. Informative References . . . . . . . . . . . . . . . . . . 14
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 15 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 15
1. Introduction 1. Introduction
1.1. This Is Markdown! Or: Markup and Its Discontents 1.1. This Is Markdown! Or: Markup and Its Discontents
In computer systems, textual data is stored and processed using a In computer systems, textual data is stored and processed using a
continuum of techniques. On the one end is plain text: computer- continuum of techniques. On the one end is plain text: computer-
skipping to change at page 10, line 18 skipping to change at page 10, line 18
More Information More Information
----------- -----------
[.markdown, .md](http://daringfireball.net/projects/markdown/) [.markdown, .md](http://daringfireball.net/projects/markdown/)
has more information. has more information.
[fOo]: http://example.com/loc 'Will Not Work with Markdown.pl-1.0.1' [fOo]: http://example.com/loc 'Will Not Work with Markdown.pl-1.0.1'
6. IANA Considerations 6. IANA Considerations
IANA is asked to register the media type text/markdown in the IANA is asked to register the media type text/markdown using the
Standards tree using the application provided in Section 2 of this application provided in Section 2 of this document.
document.
IANA is asked to register "preview-type" in the Content Disposition IANA is asked to register "preview-type" in the Content Disposition
Parameters subregistry of the Content Disposition Values and Parameters subregistry of the Content Disposition Values and
Parameters registry, with the following description: "Internet media Parameters registry, with the following description: "Internet media
type (and parameters) of the preview output desired from a processor type (and parameters) of the preview output desired from a processor
by the author of the MIME content". by the author of the MIME content".
6.1. Markdown Variants 6.1. Markdown Variants
IANA is also asked to establish a registry called "Markdown IANA is also asked to establish a registry called "Markdown
skipping to change at page 12, line 12 skipping to change at page 12, line 11
Registrations are made on a First-Come, First-Served [RFC5226] basis Registrations are made on a First-Come, First-Served [RFC5226] basis
by anyone with a need to interoperate. While documentation is by anyone with a need to interoperate. While documentation is
required, any level of documentation is sufficient; thus, neither required, any level of documentation is sufficient; thus, neither
Specification Required nor Expert Review are warranted. The checks Specification Required nor Expert Review are warranted. The checks
prescribed by this section can be performed automatically. prescribed by this section can be performed automatically.
All references (including contact information) MUST be verified as All references (including contact information) MUST be verified as
functional at the time of the registration. functional at the time of the registration.
IANA should confirm the authenticity of the senders of requests for
this registry.
As a special "escape valve", registrations can be updated with IETF As a special "escape valve", registrations can be updated with IETF
Review [RFC5226]. All fields may be updated except the variant Review [RFC5226]. All fields may be updated except the variant
identifier, which is permanent: not even case may be changed. identifier, which is permanent: not even case may be changed.
6.1.3. Provisional Registration 6.1.3. Provisional Registration
Any registrant may make a provisional registration to reserve a Any registrant may make a provisional registration to reserve a
variant identifier. Only the variant identifier and contact variant identifier. Only the variant identifier and contact
information fields are required; the rest are optional. Provisional information fields are required; the rest are optional. Provisional
registrations expire after three months, after which time the variant registrations expire after three months, after which time the variant
skipping to change at page 14, line 37 skipping to change at page 14, line 33
<http://blog.codinghorror.com/is-html-a-humane-markup- <http://blog.codinghorror.com/is-html-a-humane-markup-
language/>. language/>.
[INETMEME] Solon, O., "Richard Dawkins on the internet's hijacking of [INETMEME] Solon, O., "Richard Dawkins on the internet's hijacking of
the word 'meme'", June 2013, the word 'meme'", June 2013,
<http://www.wired.co.uk/news/archive/2013-06/20/richard- <http://www.wired.co.uk/news/archive/2013-06/20/richard-
dawkins-memes>, <http://www.webcitation.org/6HzDGE9Go>. dawkins-memes>, <http://www.webcitation.org/6HzDGE9Go>.
[MDMTGUID] Leonard, S., "Guidance on Markdown: Design Philosophies, [MDMTGUID] Leonard, S., "Guidance on Markdown: Design Philosophies,
Stability Strategies, and Select Registrations", draft- Stability Strategies, and Select Registrations", draft-
ietf-appsawg-text-markdown-use-cases-06 (work in ietf-appsawg-text-markdown-use-cases-07 (work in
progress), September 2015. progress), September 2015.
[PANDOC] MacFarlane, J., "Pandoc", 2014, [PANDOC] MacFarlane, J., "Pandoc", 2014,
<http://johnmacfarlane.net/pandoc/>. <http://johnmacfarlane.net/pandoc/>.
[RFC4263] Lilly, B., "Media Subtype Registration for Media Type [RFC4263] Lilly, B., "Media Subtype Registration for Media Type
text/troff", RFC 4263, January 2006. text/troff", RFC 4263, January 2006.
Author's Address Author's Address
 End of changes. 6 change blocks. 
11 lines changed or deleted 7 lines changed or added

This html diff was produced by rfcdiff 1.42. The latest version is available from http://tools.ietf.org/tools/rfcdiff/