Markdown Unordered Lists
Last updated: 2026-10-14
Unordered Lists CommonMark core
Create an unordered list with -, * or + plus a space. Mixing is legal, but standardizing on the dash keeps diffs clean and visuals consistent across a team.
| Group | Basic: Block |
|---|---|
| Spec level | CommonMark core |
| Spec version | CommonMark 0.31.2 + GFM |
📝 Syntax
- Item one
- Item two▶ Live Example
Edit Markdown on the left, see the result on the right
💡 Key points
💡 Tip Standardize on -: most editors auto-continue and linters agree by default.
ℹ️ Note Blank lines between items make the list loose: each item gets wrapped in <p>.
❓ FAQ
Q What happens if markers are mixed?
A A marker change starts a new list; keep one marker to avoid surprises.
Q How many spaces indent a child list?
A Align to the parent marker's first character: 2 spaces for -, 3 for 1..
Q Can a list item contain a code block?
A Yes — indent the whole fence to the item's content level.
📚 See also
Ordered ListsCommonMark core List NestingCommonMark core Tight vs Loose ListsCommonMark core