Markdown Numbered List: Ordered Lists

Numbered lists in Markdown

Lists

Markdown syntax

Works everywhere

1. First
2. Second
3. Third

A number, a period and a space.

Start each line with a number, a period and a space. Only the first number matters: the rest are counted for you, so a list of 1. 1. 1. renders as 1, 2, 3.

All ways to write it

```
1. First
2. Second
3. Third
```
A number, a period and a space.Works everywhere
```
1. First
1. Second
1. Third
```
All ones also work: the renderer numbers them, so reordering is painless.Works everywhere
```
3. Third
4. Fourth
```
The first number sets where the list starts.Works everywhere
```
1) First
```
A closing parenthesis instead of a period.Works everywhere

Example

You type

1. Install the app from the Marketplace
1. Open any page and type /markdown
1. Write on the left, check the preview on the right
1. Save the page

You get

Install the app from the Marketplace
Open any page and type /markdown
Write on the left, check the preview on the right
Save the page

Questions

Why does my numbered list restart at 1?

Something between the items ended the list, usually a code block or paragraph that isn't indented. Indent it to line up with the item's text (three spaces for "1. ") so it stays inside the item.

How do I write a year like 1986. without making a list?

Escape the period: 1986\. starts a normal paragraph.

Can I use letters or Roman numerals?

Not in CommonMark or GitHub. Pandoc supports a. and i. lists; elsewhere use an HTML <ol type="a">.

Numbered list in Confluence

Numbered lists render in a Markdown Macro+ macro, and Markdown Importer turns them into Confluence numbered lists, so the steps stay editable in the normal editor after import.