Markdown lists come in two main types: unordered lists that start with -, * or +, and ordered lists that start with a number and a period. You can nest them by indenting child items, and add task checkboxes in tools that support GitHub Flavored Markdown. This guide shows the exact syntax and the mistakes that break lists.
Key takeaways
- Use
-,*or+for bullets and1.for numbered items. - Put a space after the marker and a blank line before the list.
- Indent nested items so they line up with the text of the parent item.
- Pick one bullet character and stick with it in a document.
Unordered Markdown Lists
An unordered list is a set of items with no ranking. Start each line with a hyphen, asterisk or plus sign followed by a space.
- Buy printer paper
- Book the meeting room
- Send the agenda
All three markers give the same result. The hyphen is the most common choice, partly because it reads cleanly in plain text and does not clash with bold or italic syntax. Mixing markers in one list can cause some parsers to split it into several lists, so choose one.
Ordered Markdown Lists
For steps and rankings, begin each line with a number, a period and a space.
1. Open the file
2. Edit the text
3. Save your changes
The actual numbers you type matter less than you might expect. In CommonMark, the first number sets the starting point, and the following items are numbered in sequence when rendered. Many writers number every item 1. so that reordering lines never requires renumbering. Not every older tool follows this, so test it in your editor before relying on it.
You can also start an ordered list at another number, for example 5., which is handy when a list continues after an interruption such as a code block or a paragraph. Keep in mind that the delimiter matters: a period and a closing parenthesis (1)) are both valid in CommonMark, but changing the delimiter mid-list starts a new list, so avoid mixing them. The CommonMark specification lists every rule if you need the precise behavior.

Nested Markdown Lists
To nest, indent the child item so it sits under the text of its parent. Two to four spaces works in most tools; for an ordered parent, align with the first character after the number and period.
1. Plan the launch
- Write the announcement
- Prepare screenshots
2. Publish
1. Schedule the post
2. Share the link
You can mix types, with bullets inside numbered items or the reverse. If a nested list refuses to indent, the cause is usually a tab or an uneven number of spaces. Switch to consistent spaces and check again.
Task Lists and Multi-Paragraph Items
GitHub Flavored Markdown adds checkboxes. Write a list item followed by square brackets with a space or an x inside.
- [x] Draft outline
- [ ] Review with team
- [ ] Publish
These are an extension, not part of the core syntax, so simpler editors may show the brackets as text. The GitHub Flavored Markdown specification describes task list items and the rest of the extended syntax.
To place a second paragraph or a code block inside one item, leave a blank line and indent the new block to line up with the item text.
Quick Comparison: Which List Type to Use
| Use case | List type | Example marker |
|---|---|---|
| Features, ingredients, notes | Unordered | - |
| Steps in a procedure | Ordered | 1. |
| Outlines with sub-points | Nested | Indented - |
| To-do items | Task list | - [ ] |

Common Mistakes With Markdown Lists
- No space after the marker.
-itemis plain text; write- item. - No blank line before the list. Some parsers fail to start the list when it follows a paragraph directly.
- A year at the start of a line. Text such as
2024. A good yearbecomes a numbered list. Escape the period with a backslash:2024\. A good year. - Inconsistent indentation. Mixing tabs and spaces moves items to the wrong level.
- Loose versus tight lists. Blank lines between items wrap each item in paragraph tags, which adds spacing. Remove the blank lines for a compact list.
If you paste a list from a word processor, the formatting may not carry over cleanly. Our guide to pasting Markdown into Google Docs without messy formatting explains what to expect, and the Markdown cheat sheet lists the other basic elements for reference.
Frequently Asked Questions
What is the difference between -, * and + in a list?
There is none in the rendered result. They are interchangeable bullet markers, so use whichever you like and stay consistent.
How many spaces do I need to nest a list?
Two to four spaces works in most editors. Aligning with the parent item’s text is the safest rule.
Why does my numbered list restart or skip?
A paragraph or blank line without indentation ends the list. Indent anything that belongs to an item so the numbering continues.
Can I put code inside a list item?
Yes. Indent the fenced code block to the same level as the item text, with a blank line before it.
Do task lists work everywhere?
No. They are part of GitHub Flavored Markdown and some note apps, but plain Markdown processors may display them as text.
Wrap-Up
Choose one marker, keep indentation consistent and leave blank lines around the list. With those habits, markdown lists render the same way in almost any editor. Test a short sample in the tool you use, since small differences remain.



