# writing-internet-drafts-in-markdown

**Repository Path**: mirrors_nox/writing-internet-drafts-in-markdown

## Basic Information

- **Project Name**: writing-internet-drafts-in-markdown
- **Description**: A presentation (in Markdown) for the IETF Hub Boston on June 12, 2018.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-14
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

This repo contains information about creating Internet Drafts in Markdown. 

Internet Drafts are the starting point for the standards process within the 
[Internet Engineering Task Force (IETF)](https://www.ietf.org/). Also referred to 
as "drafts" or "IDs", anyone can create an Internet Draft and submit it through
the [IETF datatracker](https://datatracker.ietf.org/).

Internet Drafts can be created using a variety of tools and templates. The primary 
mechanism for the past while has been to use XML and the [xml2rfc tool](https://pypi.org/project/xml2rfc/))
(also [available online](https://xml2rfc.tools.ietf.org/)).

In recent years, new tools have emerged allowing the creation of Internet Drafts using
variations of [Markdown syntax](https://daringfireball.net/projects/markdown/). Multiple
tools are available, but two of the more prominent are:

- **[kramdown-rfc](https://github.com/cabo/kramdown-rfc2629)** by Carsten Bormann
- **[mmark](https://github.com/mmarkdown/mmark)** by Miek Gieben

This repo includes:

- Slides from a presentation I gave on June 12, 2018, at the "IETF Hub Boston" meeting 
  in Cambridge, MA. (The slides themselves are in Markdown).
- Slides from a tutorial on March 24, 2019, at IETF 104 in Prague.
- Examples of markdown files for both the kramdown and mmark tools.

Additional examples and information about getting started with Internet Drafts 
[can be found in Martin Thomson's i-d-template repo](https://github.com/martinthomson/i-d-template).