Dismiss
  • Scroll up
  • Toggle Theme
  • View as Mobile

Lists

Style for lists

Ordered List

  1. First ordered list item
  2. Second ordered list item
  3. Third ordered list item
  4. Fourth ordered list item
1. First ordered list item
2. Second ordered list item
3. Third ordered list item
4. Fourth ordered list item

Unordered List

  • Item One
  • Item Two
  • Item Three
  • Item Four
- Item One
- Item Two
- Item Three
- Item Four

Ordered List with children

  1. Item one
    1. Ordered list child 1
    2. Ordered list child 2
  2. Item two
    1. Ordered list child one
    2. Ordered list child two
  3. Item three
    1. Ordered list child three
    2. Ordered list child three
1. Item one
    1. Ordered list child 1
    2. Ordered list child 2
2. Item two
    1. Ordered list child one
    2. Ordered list child two
3. Item three
    1. Ordered list child three
    2. Ordered list child three

Ordered List with grand children

  1. Item one
    1. Ordered list child 1
    2. Ordered list child 2
  2. Item two
    1. Ordered list child one
    2. Ordered list child two
      1. grandchildren one
      2. grandchildren two
      3. grandchildren three
  3. Item with unordered children
    • One
    • Two
  4. Item with unordered deep children
    • One
      • Woah
        • Deep
          • Children
    • Two
      • Woah two
        • Very Deep
          • Children

Unordered List with children

  • Item One
  • Item Two
  • Item Four with children
    • child 1
    • child 2
    • child 3
    • child 4 with children
      • grandchild one
      • grandchild two
  • Item Five with children
    1. child 1
    2. child 2
      • unordered child 1
      • unordered child 2
      • unordered child 3 with children
        • grandchild one
        • grandchild two
  • Last item

Nested Mixed List

  • Item

    1. First Sub-item
    2. Second Sub-item
  • Bold Text. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer vitae mauris arcu, eu pretium nisi. Praesent fringilla ornare ullamcorper. Pellentesque diam orci, sodales in blandit ut, placerat quis felis. Vestibulum at sem massa, in tempus nisi. Vivamus ut fermentum odio. Etiam porttitor faucibus volutpat. Vivamus vitae mi ligula, non hendrerit urna. Suspendisse potenti. Quisque eget massa a massa semper mollis.

  • Nested list with paragraph. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer vitae mauris arcu, eu pretium nisi. Praesent fringilla ornare ullamcorper. Pellentesque diam orci, sodales in blandit ut, placerat quis felis. Vestibulum at sem massa, in tempus nisi. Vivamus ut fermentum odio. Etiam porttitor faucibus volutpat. Vivamus vitae mi ligula, non hendrerit urna. Suspendisse potenti. Quisque eget massa a massa semper mollis.

    • list item 1
    • list item 2
    • list item 3
    • list item long Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer vitae mauris arcu, eu pretium nisi. Praesent fringilla ornare ullamcorper.
  • Nested ordered list with paragraph. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer vitae mauris arcu, eu pretium nisi. Praesent fringilla ornare ullamcorper. Pellentesque diam orci, sodales in blandit ut, placerat quis felis. Vestibulum at sem massa, in tempus nisi. Vivamus ut fermentum odio. Etiam porttitor faucibus volutpat. Vivamus vitae mi ligula, non hendrerit urna. Suspendisse potenti. Quisque eget massa a massa semper mollis.

    1. list item 1
    2. list item 2
    3. list item 3
    4. list item long Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer vitae mauris arcu, eu pretium nisi. Praesent fringilla ornare ullamcorper.
  • Excamera - video encoding, a functional video codec for fine-grained parallelism
  • Lepton - JPEG recompression, a functional JPEG codec for boundary oblivious sharding
  • Salsify - video conferencing codec to find optimal encoding rates
  • GG - thunk abstraction to infer a lambda expression & evaluate in serverless compute
  • CC-lambda
  • Pywren - Run your existing python code at massive scale via AWS Lambda
  • serverless-artillery - performance testing at scale
  • lambci - A continuous integration system built on AWS Lambda
  • Parallel image processing

List syntaxes

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

Unordered lists use asterisks, pluses, and hyphens -- interchangably -- as list markers:

Bullet * Lists

Bullets can be rendered with *.

* Red
* Green
* Blue

Rendered as:

  • Red
  • Green
  • Blue

Plus sign + Lists

Bullets can also be rendered with +.

+ Red
+ Green
+ Blue

Rendered as:

  • Red
  • Green
  • Blue

Dash - Lists

Bullets can also be rendered with -.

- Red
- Green
- Blue

Rendered as:

  • Red
  • Green
  • Blue

Ordered Lists

Ordered lists use numbers followed by periods:

1. Bird
2. McHale
3. Parish

Rendered as:

  1. Bird
  2. McHale
  3. Parish

It's important to note that the actual numbers you use to mark the list have no effect on the HTML output Markdown produces. The HTML Markdown produces from the above list is:

<ol>
  <li>Bird</li>
  <li>McHale</li>
  <li>Parish</li>
</ol>

If you instead wrote the list in Markdown like this:

1. Bird
1. McHale
1. Parish

Rendered as:

  1. Bird
  2. McHale
  3. Parish

or even:

3. Bird
1. McHale
8. Parish

Rendered as:

  1. Bird
  2. McHale
  3. Parish

You'd get the exact same HTML output. The point is, if you want to, you can use ordinal numbers in your ordered Markdown lists, so that the numbers in your source match the numbers in your published HTML. But if you want to be lazy, you don't have to.

If you do use lazy list numbering, however, you should still start the list with the number 1. At some point in the future, Markdown may support starting ordered lists at an arbitrary number.

List markers typically start at the left margin, but may be indented by up to three spaces. List markers must be followed by one or more spaces or a tab.

To make lists look nice, you can wrap items with hanging indents:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

Rendered as:

  • Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
  • Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

But if you want to be lazy, you don't have to:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

If list items are separated by blank lines, Markdown will wrap the items in <p> tags in the HTML output. For example, this input:

* Bird
* Magic

Rendered as:

  • Bird
  • Magic

will turn into:

<ul>
  <li>Bird</li>
  <li>Magic</li>
</ul>

But this:

* List line with spaces turn into paragraph

* List line with spaces turn into paragraph 2

Rendered as:

  • List line with spaces turn into paragraph

  • List line with spaces turn into paragraph 2

will turn into:

<ul>
  <li><p>List line with spaces turn into paragraph</p></li>
  <li><p>List line with spaces turn into paragraph 2</p></li>
</ul>

List items may consist of multiple paragraphs. Each subsequent paragraph in a list item must be indented by either 4 spaces or one tab:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

Rendered as:

  1. This is a list item with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. Donec sit amet nisl. Aliquam semper ipsum sit amet velit.

  2. Suspendisse id sem consectetuer libero luctus adipiscing.


It looks nice if you indent every line of the subsequent paragraphs, but here again, Markdown will allow you to be lazy:

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

Rendered as:

  • This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're only required to indent the first line. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.

  • Another item in the same list.


To put a blockquote within a list item, the blockquote's > delimiters need to be indented:

*   A list item with a blockquote:

    > This is a blockquote
    >
    > inside a list item.

Rendered as:

  • A list item with a blockquote:

    This is a blockquote

    inside a list item.


To put a code block within a list item, the code block needs to be indented twice -- 8 spaces or two tabs:

*   A list item with a code block:

    ```
    console.log('x')
    ```

Rendered as:

  • A list item with a code block:

    console.log('x')

It's worth noting that it's possible to trigger an ordered list by accident, by writing something like this:

1986. What a great season.

Rendered as:

  1. What a great season.

In other words, a number-period-space sequence at the beginning of a line. To avoid this, you can backslash-escape the period:

1986\. What a great season.

Rendered as:

1986. What a great season.