Markdown Cheatsheet:
Toolbar Style

An intuitive markdown cheatsheet. Uses a toolbar similar to the ones used by MS Word, Google Docs, Evernote, Wordpress, etc.

To get started, click on one of the buttons below ↓

Paragraphs

Paragraphs should be separated by a single blank line, i.e. hit the return key twice.

Markdown
This is paragraph 1. This is paragraph 1.

This is paragraph 2. This is paragraph 2.

This is paragraph 3. This is paragraph 3.

Result

This is paragraph 1. This is paragraph 1.

This is paragraph 2. This is paragraph 2.

This is paragraph 3. This is paragraph 3.

To break a line without creating a new paragraph, use <br> tag.

Markdown
This is paragraph 1.<br>This is still paragraph 1.

Result
This is paragraph 1.
This is still paragraph 1.

Headings

You can't change font sizes in markdown, but you can create headings.

Begin a line with one or more of # to create a heading. The number of # corresponds to the heading level. You can specify up to 6 levels of headings.

Markdown
# Heading Level 1

## Heading Level 2

### Heading Level 3

This is a paragraph.

#### Heading Level 4

##### Heading Level 5

###### Heading Level 6

This is a paragraph.

Result

Heading Level 1

Heading Level 2

Heading Level 3

This is a paragraph.

Heading Level 4

Heading Level 5
Heading Level 6

This is a paragraph.

Optionally, you can label a line with === to create a level 1 heading, or with --- to create a level 2 heading. I don't recommend using this: using # is much simpler and more flexible.

Markdown
Heading Level 1
===============

This is a paragraph.

Heading Level 2
---------------

This is a paragraph.

Result

Heading Level 1

This is a paragraph.

Heading Level 2

This is a paragraph.

Bold

Wrap phrases with two asterisks (*) to bold the text.

Markdown
**This text will be bold**

Result

This text will be bold

You can also use two underscores.

Markdown
__This text will be bold__

Result

This text will be bold

Italic

Wrap phrases with one asterisk (*) to italicize the text.

Markdown
*This text will be italic*

Result

This text will be italic

You can also use one underscore.

Markdown
_This text will be italic_

Result

This text will be italic

Underline

Underline is not supported in Markdown. However, Markdown supports HTML, so you can use <u> tags to underline text.

Markdown
Use HTML to <u>underline text</u> in markdown.

Result
Use HTML to underline text in markdown.

Strikethrough

Strikethrough is not supported in Markdown (unless you're using it on GitHub, which lets you use ~~text~~ syntax for strikethrough). However, Markdown supports HTML, so you can use <del> tags to strikethrough text.

Markdown
Use HTML to <del>strikethrough text</del> in markdown.

Result
Use HTML to strikethrough text in markdown.

Images

To add an image, follow this format: ![Image Name](Image Address). Image name helps search engines and screenreaders understand the image.

To add an image with a link, follow this format: [![Image Name](Image Address)](Link Address).

Markdown
Image:

![Shut up](http://goo.gl/iCJCgQ)

Image with a link to **http://twitter.com/chibicode**:

[![Sketch](http://goo.gl/74fTfU)](http://twitter.com/chibicode)

Result

Image:

Shut up

Image with a link to http://twitter.com/chibicode:

Sketch

Quotes

To convert a paragraph to a quote, begin the paragraph with >. Make sure to separate the quote from other paragraphs/lists using a blank line.

Markdown
Here's a quote from Albert Einstein:

> Two things are infinite: **the universe** and **human stupidity**; and I'm not sure about the universe.

Result

Here's a quote from Albert Einstein:

Two things are infinite: the universe and human stupidity; and I'm not sure about the universe.

You can create multi-paragraph quotes by separating each paragraph with a blank line.

Markdown
Here's a quote from Marilyn Monroe:

> I'm selfish, impatient and a little insecure. I make mistakes, I am out of control and at times hard to handle.

> But if you can't handle me at my worst, then you sure as hell don't deserve me at my best.

Result

Here's a quote from Marilyn Monroe:

I'm selfish, impatient and a little insecure. I make mistakes, I am out of control and at times hard to handle.

But if you can't handle me at my worst, then you sure as hell don't deserve me at my best.

Bulleted List

To create a bulleted list, start each line with dashes. Make sure to separate the list from other paragraphs/lists using a blank line.

Markdown
This is a paragraph.

- List Item 1
- List Item 2
- List Item 3

This is another paragraph.

Result

This is a paragraph.

  • List Item 1
  • List Item 2
  • List Item 3

This is another paragraph.

You can also use asterisks or plus signs.

Markdown
* List Item 1
* List Item 2
* List Item 3

Or:

+ List Item 1
+ List Item 2
+ List Item 3

Result
  • List Item 1
  • List Item 2
  • List Item 3

Or:

  • List Item 1
  • List Item 2
  • List Item 3

To create nested lists, indent an item by four spaces at each level.

Markdown
- List Item 1
    - List Item 1.1
    - List Item 1.2
        - List Item 1.2.1
    - List Item 1.3

Result
  • List Item 1
    • List Item 1.1
    • List Item 1.2
      • List Item 1.2.1
    • List Item 1.3

To make each list item multi-paragraph, add four spaces to the beginning of each paragraph after the first paragraph.

Markdown
- List Item 1

    Second paragraph of list item 1

    Third paragraph of list item 1

- List Item 2

    Second paragraph of list item 2

    Third paragraph of list item 2

Result
  • List Item 1

    Second paragraph of list item 1

    Third paragraph of list item 1

  • List Item 2

    Second paragraph of list item 2

    Third paragraph of list item 2

Numbered List

To create a numbered list, start each line with a number, followed by a period. Make sure to separate the list from other paragraphs/lists using a blank line.

Markdown
This is a paragraph.

1. List Item 1
2. List Item 2
3. List Item 3

This is a paragraph.

Result

This is a paragraph.

  1. List Item 1
  2. List Item 2
  3. List Item 3

This is a paragraph.

You can also use 1. for every item.

Markdown
1. List Item 1
1. List Item 2
1. List Item 3

Result
  1. List Item 1
  2. List Item 2
  3. List Item 3

To create nested lists, indent an item by four spaces at each level. Don't write 1.1. or 1.1.1. etc.

Markdown
1. List Item
    1. List Item
    2. List Item
        1. List Item
    3. List Item

Result
  1. List Item
    1. List Item
    2. List Item
      1. List Item
    3. List Item

To make each list item multi-paragraph, add four spaces to the beginning of each paragraph after the first paragraph.

Markdown
1. List Item 1

    Second paragraph of list item 1

    Third paragraph of list item 1

2. List Item 2

    Second paragraph of list item 2

    Third paragraph of list item 2

Result
  1. List Item 1

    Second paragraph of list item 1

    Third paragraph of list item 1

  2. List Item 2

    Second paragraph of list item 2

    Third paragraph of list item 2

Horizontal Line

Replace a paragraph with three dashes to draw a horizontal line.

Markdown
This is paragraph 1.

---

This is paragraph 2.

Result

This is paragraph 1.


This is paragraph 2.

Code and Other Advanced Stuff

You can format code in markdown too. For inline code, wrap code in backticks like this. For multi-line code blocks, wrap code in three backticks. Make sure to separate the block from other paragraphs/lists using a blank line.

If you're going to use Markdown on GitHub or related sites, read about GitHub Flavored Markdown here.

Markdown
Usage: `hello("chibicode")`

```ruby
def hello(name)
  puts "Hello #{name}!"
end
```

Result

Usage: hello("chibicode")

def hello(name)
  puts "Hello #{name}!"
end