Markdown Features
Lists

Lists

Create organized content using ordered, unordered, and task lists.

Unordered Lists

Create unordered lists using -, *, or +:

- Item 1
- Item 2
- Item 3
  • Item 1
  • Item 2
  • Item 3

Nested Lists

- Parent item 1
  - Child item 1
  - Child item 2
    - Grandchild item
- Parent item 2
  • Parent item 1
    • Child item 1
    • Child item 2
      • Grandchild item
  • Parent item 2

Ordered Lists

Create ordered lists using numbers followed by periods:

1. First item
2. Second item
3. Third item
  1. First item
  2. Second item
  3. Third item

Auto-numbering

Markdown will automatically number items, so you can use 1. for all items:

1. First item
1. Second item (will display as 2)
1. Third item (will display as 3)
  1. First item
  2. Second item (will display as 2)
  3. Third item (will display as 3)

Nested Ordered Lists

1. First level item 1
   1. Second level item 1
   2. Second level item 2
2. First level item 2
   1. Second level item 1
      1. Third level item 1
  1. First level item 1
    1. Second level item 1
    2. Second level item 2
  2. First level item 2
    1. Second level item 1
      1. Third level item 1

Task Lists

Create interactive checkboxes using - [ ] for unchecked and - [x] for checked items:

- [x] Completed task
- [x] Another completed task
- [ ] Pending task
- [ ] Another pending task
  • Completed task
  • Another completed task
  • Pending task
  • Another pending task

Nested Task Lists

- [x] Main task
  - [x] Subtask 1
  - [ ] Subtask 2
- [ ] Another main task
  - [ ] Subtask A
  - [ ] Subtask B
  • Main task
    • Subtask 1
    • Subtask 2
  • Another main task
    • Subtask A
    • Subtask B

Mixed Lists

You can mix ordered and unordered lists:

1. First ordered item
2. Second ordered item
   - Unordered sub-item
   - Another unordered sub-item
3. Third ordered item
   1. Ordered sub-item
   2. Another ordered sub-item
  1. First ordered item
  2. Second ordered item
    • Unordered sub-item
    • Another unordered sub-item
  3. Third ordered item
    1. Ordered sub-item
    2. Another ordered sub-item

Lists with Multiple Paragraphs

Include multiple paragraphs in list items by indenting:

1. First item with multiple paragraphs.
 
   This is the second paragraph of the first item.
   
   And a third paragraph.
 
2. Second item.
  1. First item with multiple paragraphs.

    This is the second paragraph of the first item.

    And a third paragraph.

  2. Second item.

Lists with Code Blocks

Include code blocks in lists by indenting:

1. First item:
 
   ```javascript
   console.log("Hello");
  1. Second item with inline code: const x = 5

1. First item:

   ```javascript
   console.log("Hello");
  1. Second item with inline code: const x = 5

Lists with Blockquotes

Include blockquotes in lists:

- First item
 
  > This is a blockquote
  > inside a list item
 
- Second item
  • First item

    This is a blockquote inside a list item

  • Second item