# Nested ordered list numbering

**URL:** <https://talk.commonmark.org/t/nested-ordered-list-numbering/4210>\
**Category:** Spec\
**Created:** [June 20, 2022, 2:04pm UTC](https://talk.commonmark.org/t/nested-ordered-list-numbering/4210 "2022-06-20T14:04:37Z")\
**Posts on this page:** 1\
**Showing post:** 2

<div class="post-metadata">

**Author:** ![vas](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/vas/32/1267_2.png) [@vas](https://talk.commonmark.org/u/vas)\
**Post date:** [June 21, 2022, 7:38am UTC](https://talk.commonmark.org/t/nested-ordered-list-numbering/4210/2 "2022-06-21T07:38:31Z")

</div>

From [the spec’s rules for list items](https://spec.commonmark.org/0.29/#list-items):

> 1. When the first list item in a [list](https://spec.commonmark.org/0.29/#list) interrupts a paragraph—that is, when it starts on a line that would otherwise count as [paragraph continuation text](https://spec.commonmark.org/0.29/#paragraph-continuation-text)—then (a) the lines _Ls_ must not begin with a blank line, and (b) if the list item is ordered, the start number must be 1.

In your examples, the first element of the first list item is the paragraph “One”. Your first example does not work because the sublist interrupts this paragraph, while your second example does work because it has a blank line between the paragraph and the sublist.

> [@floda](#):
>
> but causes newlines where none belong:

There are no newlines being created. The visual difference is a loose list versus a tight list. A tight list by definition involves paragraph interruption. But because of the above rule, you cannot interrupt a paragraph with a list item numbered other than `1`.

To understand the reasons for this, read [the spec section for Lists](https://spec.commonmark.org/0.29/#lists), which discusses loose vs tight lists as well as why “we allow only lists starting with `1` to interrupt paragraphs.”

This issue has been extensively discussed in this forum:

- [Blank lines before lists, revisited](https://talk.commonmark.org/t/blank-lines-before-lists-revisited/1990)
- original spec discussion: [Requiring a blank line between a paragraph and list](https://talk.commonmark.org/t/requiring-a-blank-line-between-a-paragraph-and-list/657)
- most recent revisit: [Ordered lists and sublist starts](https://talk.commonmark.org/t/ordered-lists-and-sublist-starts/3693)

---

_[View the full topic](https://talk.commonmark.org/t/nested-ordered-list-numbering/4210)._