# Markdown Basics

Markdown is an easy-to-read and easy-to-use syntax for styling all forms of writing.

## Paragraphs

A paragraph is simply one or more consecutive lines of text, separated by one or more blank lines. Normal paragraphs should not be indented with spaces or tabs.

If you want to insert a `<br />` break tag using Markdown, end a line with two or more spaces, then type return.

## Headings

Create a heading by adding one or more `#` symbols before your heading text. The number of `#` you use will determine the size of the heading.

    # This is an H1
    ## This is an H2
    ###### This is an H6

## Blockquotes

Indicate blockquotes with a `>`.

    To quote Jean-Luc Picard:
    > Make it so.

Blockquotes can be nested by adding additional levels of `>`.

    > This is the first level of quoting.
    >
    > > This is a nested blockquote.
    >
    > Back to the first level.

## Bold and Italics

You can make text bold or italic. Both bold and italic can use either an asterisk `*` or an underscore `_` to style text.

    **bold** or *italic*
    __bold__ or _italic_

You can combine both bold and italic to nest one within the other.

    **The same character _must_ be used to open and close bold or italic text.**

## Lists

Markdown supports unordered (bulleted) and ordered (numbered) lists.

### Unordered lists

Make unordered (bulleted) lists by prepending list items with an asterisk `*` or hyphen `-`.

    * Item
    * Item
    * Item

    - Item
    - Item
    - Item

Lists can also contain multiple paragraphs.

    *   Unordered item.

    With multiple paragraphs.

    *   Another unordered item

### Ordered lists

Make ordered lists by using regular numbers, followed by periods, as list marker.

    1. Item one
    2. Item two
    3. Item three

### Nested lists

You can nest lists by indenting list items by four spaces.

    1. Item one
        1. First nested item
        2. Second nested item
    2. Item two
        * Unordered nested item
            1. Ordered item
            2. Second ordered item
            3. Consider creating a new list
        * Another unordered nested item
    3. Item three

## Links

Markdown supports two styles for creating links: inline and reference. Use square brackets `[` `]` to delimit the text you want to turn into a link. Titles are optional.

### Inline links

Inline-style links use parentheses immediately after the link text.

    An [example](http://url.com/ "Title")

### Reference links

Reference-style links allow you to refer to your links by names, which you define elsewhere in your document:

    Here at [Realmac][1], we use [Typed][2] as our Markdown editor of choice.

    [1]: http://realmacsoftware.com/ "Realmac"
    [2]: http://realmacsoftware.com/typed/ "Typed"

### Email links

    An example <email@address.com> link

## Images

Image syntax is very much like link syntax. As with links, titles are optional.

### Inline-style images

    ![alt text](/path/to/img.jpg "Title")

### Reference-style images

    ![alt text][id]

    [id]: /path/to/img.jpg "Title"

## Code

### Inline code

In a regular paragraph, you can create `<code>` span by wrapping text in backtick ``` quotes.

    An example of inline `<code>`

Any ampersands `&` and angle brackets `<` `>` will automatically be translated into HTML entities.

### Fenced code blocks

To specify an entire block of pre-formatted code, indent every line of the block by 4 spaces or 1 tab.

You can also create a fenced code block by wrapping the code with 3 backticks `````.

    ```
    An example fenced code block
    ```

## Horizontal rules

Make a horizontal rule using three or more dashes `-` or asterisks `*`.

    ---

    * * *

    - - - -