Markdownチュートリアル

Lists

Create ordered and unordered lists

List Syntax

You can organize items into ordered or unordered lists.

Ordered Lists

Markdown SyntaxHTML SyntaxRendered Output
1. item first
2. item second
3. item third
  1. item first
  2. item second
  3. item third
1. item first
2. item second
3. item third
1. item first
2. item second
3. item third
    4. item fourth
  1. item first
  2. item second
  3. item third
    1. item fourth
1. item first
2. item second
3. item third
    4. item fourth

Best Practices for Ordered Lists

Markdown allows you to use ) as a delimiter, but for compatibility reasons, please don't do this.

✅ Do this❌ Don't do this
1. item first
2. item second
3. item third
1) item first
2) item second
3) item third

Unordered Lists

Markdown SyntaxHTML SyntaxRendered Output
- item first
- item second
- item third
  • item first
  • item second
  • item third
- item first
- item second
- item third
- item first
- item second
- item third
    - item fourth
  • item first
  • item second
  • item third
    • item fourth
- item first
- item second
- item third
    - item fourth
+ item first
+ item second
+ item third
  • item first
  • item second
  • item third
+ item first
+ item second
+ item third
* item first
* item second
* item third
  • item first
  • item second
  • item third
* item first
* item second
* item third
* item first
* item second
* item third
    * item fourth
  • item first
  • item second
  • item third
    • item fourth
* item first
* item second
* item third
    * item fourth

Best Practices for Unordered Lists

Different Markdown applications handle the same delimiters inconsistently. It's recommended to use the same delimiter throughout a single list.

✅ Do this❌ Don't do this
- item first
- item second
- item third
* item first
- item second
+ item third

Nesting Other Elements in Lists

To add another element in a list while preserving the continuity of the list, indent the element four spaces or one tab, as shown below:

Adding Paragraphs

* This is the first list item.
* Here is the second list item.
    add another paragraph in the same list item.
* This is the third list item.

Rendered output:

  • This is the first list item.

  • Here is the second list item.

    add another paragraph in the same list item.

  • This is the third list item.

Adding Blockquotes

* This is the first list item.
* Here is the second list item. 

    > A blockquote would look great below the second list item.
* This is the third list item.

Rendered output:

  • This is the first list item.

  • Here is the second list item.

    A blockquote would look great below the second list item.

  • This is the third list item.

Adding Images

* This is the first list item.
* Here is the second list item. 

    ![A picture would look great below the second list item.](/assets/images/flower.jpg)
* This is the third list item.

Rendered output:

  • This is the first list item.

  • Here is the second list item.

    A picture would look great below the second list item.

  • This is the third list item.