Markdown is intended to be as easy-to-read and easy-to-write as is feasible.
<h3 id="html">Inline HTML</h3>
Markdown's syntax is intended for one purpose: to be used as a format for *writing* for the web.
<h3 id="autoescape">Automatic Escaping for Special Characters</h3>
In HTML, there are two characters that demand special treatment: `<` and `&`.
<h2 id="block">Block Elements</h2>
<h3 id="p">Paragraphs and Line Breaks</h3>
A paragraph is simply one or more consecutive lines of text, separated by one or more blank lines.
<h3 id="header">Headers</h3> Markdown supports two styles of headers, [Setext]  and [atx].
<h3 id="blockquote">Blockquotes</h3> Markdown uses email-style `>` characters for blockquoting. If you're familiar with quoting passages of text in an email message, then you know how to create a blockquote in Markdown.
<h3 id="list">Lists</h3> Markdown supports ordered (numbered) and unordered (bulleted) lists.
<h3 id="precode">Code Blocks</h3> Pre-formatted code blocks are used for writing about programming or markup source code. Rather than forming normal paragraphs, the lines of a code block are interpreted literally.
<h3 id="hr">Horizontal Rules</h3> You can produce a horizontal rule tag (`<hr />`) by placing three or more hyphens, asterisks, or underscores on a line by themselves.
1 2 3 4 5 6 7 8 9 10 11
* [Overview](#overview) * [Philosophy](#philosophy) * [Inline HTML](#html) * [Automatic Escaping for Special Characters](#autoescape) * [Block Elements](#block) * [Paragraphs and Line Breaks](#p) * [Headers](#header) * [Blockquotes](#blockquote) * [Lists](#list) * [Code Blocks](#precode) * [Horizontal Rules](#hr)