Markdown Cheat Sheet
Markdown is a wonderfully simple approach to creating web pages, written by John Gruber of Daring Fireball. You get on with the business of writing (without any fancy code) and Markdown takes care of producing clean, web standards compliant HTML.
The Daring Fireball site provides full documentation for Markdown, but the following examples should get you started.
You can define headings of different levels when creating a web page. The most important heading (which typically only occurs once on each page – at the top) is heading 1. A level 1 heading can be created with Markdown by typing a single ’#’ character at the start of a line. The heading at the top of this page was defined like this:
# Markdown Cheat Sheet
To create a secondary heading (such as the one for this section) you just use two ’#’ characters, like so:
## Section Headings
You can use up to six ’#’ characters to create a level 6 heading, but you will probably find that you don’t need to nest your headings quite so deeply!
Paragraphs are very easy; separate them with a blank line. You can write your paragraph on one long line, or you can wrap the lines yourself if you prefer.
This section was marked up like so:
Paragraphs are very easy; separate them with a blank line. You can write your paragraph on one long line, or you can wrap the lines yourself if you prefer. This section was marked up like so:
Bold and Italics
It’s very easy to add emphasis with bold and italics:
It's **very** easy to do **bold** and *italics*:
You can also use underscores if you prefer:
It's __very__ easy to do __bold__ and _italics_:
Create simple links by wrapping square brackets around the link text and round brackets around the URL:
If you want to give your readers an extra about the link that they’re about to follow you can set a link title:
[Nesta CMS](http://effectif.com/nesta "Nesta is a superb CMS")
Titles usually appear as a tooltip when you hover over the link, and help search engines work out what a page is about.
Start each line with hyphen or an asterisk, followed by a space. List items can be nested. This text:
* Bullet 1 * Bullet 2 * Bullet 2a * Bullet 2b * Bullet 3
…produces this list:
- Bullet 2a
- Bullet 2b
Start each line with number and a period, then a space. This text…
1. Baked potato 2. Baked beans 3. Pepper
…produces this list:
- Baked potato
- Baked beans
If you need to cite a paragraph of somebody else’s work you really ought to attribute it to them properly by using HTML’s
<blockquote/> tag. You can produce it with Markdown by adding a single ’>’ character at the beginning of the line.
> One thing was certain, that the white kitten had had nothing > to do with it -- it was the black kitten's fault entirely. For > the white kitten had been having its face washed by the old cat, > for the last quarter of an hour (and bearing it pretty well, > considering) so you see that it couldn't have had any hand in > the mischief. <cite>Lewis Carroll, Through the Looking > Glass</cite>
One thing was certain, that the white kitten had had nothing to do with it – it was the black kitten’s fault entirely. For the white kitten had been having its face washed by the old cat, for the last quarter of an hour (and bearing it pretty well, considering) so you see that it couldn’t have had any hand in the mischief. -- Lewis Carroll, Through the Looking Glass