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 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 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 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.