Lists
Create ordered and unordered lists
List Syntax
You can organize items into ordered or unordered lists.
Ordered Lists
| Markdown Syntax | HTML Syntax | Rendered Output |
|---|---|---|
1. item first2. item second3. item third |
| 1. item first 2. item second 3. item third |
1. item first2. item second3. item third4. 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 first2. item second3. item third | 1) item first2) item second3) item third |
Unordered Lists
| Markdown Syntax | HTML Syntax | Rendered Output |
|---|---|---|
- 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 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 |
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.

* This is the third list item.
Rendered output:
-
This is the first list item.
-
Here is the second list item.

-
This is the third list item.