Markdown Ordered List (Custom Start)
How to start a markdown ordered list at a number other than 1. Syntax, examples, and continuing lists across paragraphs.
What is markdown ordered list (custom start)?
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.
Syntax
Standard (starts at 1)
Normal ordered list. The actual numbers you type do not matter — most parsers use sequential numbering.
- First
- Second
- Third
Start at 5
Use 5. to start the list at 5. The first number sets the start value.
- Fifth step
- Sixth step
- Seventh step
Lazy numbering
All items use 1. — the parser auto-increments. This is valid CommonMark and makes reordering easier.
- First
- Second
- Third
Platform support
| Platform | Supported | Notes |
|---|---|---|
| GitHub | Yes | — |
| GitLab | Yes | — |
| Obsidian | Yes | — |
| Discord | Partial | Renders sequential numbers regardless of source |
| Notion | Yes | — |
| Slack | Partial | — |
Common mistakes
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.
Tips for ordered list (custom start)
Writing 1. for every item means you never need to renumber when you add or remove steps. Most parsers handle the incrementing automatically.
Frequently asked questions
Everything you need to know.
How do I start a markdown numbered list at a number other than 1?
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.
Related elements
Numbered List
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 List
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 List
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.
Try it in the editor
Paste your markdown and see ordered list (custom start) rendered instantly with professional themes.