How to start a markdown ordered list at a number other than 1. Syntax, examples, and continuing lists across paragraphs.
Ordered lists in markdown normally start at 1. By changing the number before the first period, you can start at any number. This is useful when continuing a numbered list after an interruption, or when steps continue from a previous section.
Normal ordered list. The actual numbers you type do not matter — most parsers use sequential numbering.
Use 5. to start the list at 5. The first number sets the start value.
All items use 1. — the parser auto-increments. This is valid CommonMark and makes reordering easier.
| Platform | Supported | Notes |
|---|---|---|
| GitHub | Yes | — |
| GitLab | Yes | — |
| Obsidian | Yes | — |
| Discord | Partial | Renders sequential numbers regardless of source |
| Notion | Yes | — |
| Slack | Partial | — |
Expecting specific numbers to render
Only the first number matters
In CommonMark, only the first list item's number determines the start. Subsequent numbers are ignored — the list auto-increments.
Writing 1. for every item means you never need to renumber when you add or remove steps. Most parsers handle the incrementing automatically.
Everything you need to know.
Simply start your first item with the desired number: 5. will begin the list at 5. Only the first item's number affects the starting value.
Numbered lists (ordered lists) in markdown start each item with a number followed by a period and a space (1. ). Markdown auto-numbers the output regardless of the numbers you type — all items could be "1." and the rendered list would still count correctly.
Bullet lists (unordered lists) in markdown start each item with a dash (-), asterisk (*), or plus sign (+) followed by a space. They're the most common way to present non-sequential items, features, or options.
Nested lists are created by indenting list items with 2–4 spaces (or a tab). You can nest unordered lists inside ordered lists and vice versa. The level of indentation determines the depth of nesting.
Paste your markdown and see ordered list (custom start) rendered instantly with professional themes.