Markdown bullet points and lists

Start a line with a dash for a bullet point or a number and a full stop for a numbered list. Indent to nest.

- Bullet one
- Bullet two
  - Nested bullet
  - Another
- Bullet three

1. First
2. Second
   1. Sub-step
3. Third

7. Lists can start at any number
8. like this

Bullet points

Start each line with -, * or + followed by a space. Pick one marker and stick to it: switching markers starts a new list.

Numbered lists

Use a number followed by . or ). Only the first number matters: 1. 1. 1. renders as 1, 2, 3, which makes reordering easy. Starting at 7. makes the list begin at 7.

Nested lists

Indent the child items so they line up with the text of the parent item: 2 spaces under - , 3 under 1. . Four spaces works in most renderers too.

Paragraphs and code in a list item

Leave a blank line and indent the continuation to the same text column. The same rule lets you put a fenced code block inside a step.

Stopping a list

Two lists back-to-back merge. Put an HTML comment <!-- --> between them to split them.

A number that isn’t a list

A line like 2026. What a year. becomes a list. Escape the dot: 2026\. What a year.

Quick answers

How do I make bullet points in Markdown?
Start each line with - and a space.
How many spaces do nested lists need?
Enough to align with the parent’s text: 2 for -, 3 for 1..
Why does my numbered list restart at 1?
A non-indented paragraph or code block between items ended the list. Indent the content to keep it inside the item.