# What changed in @tiptap/extension-list

> 22 changes in @tiptap/extension-list 3 from its official release notes, upgrade guides and advisories: 3 breaking, 1 new APIs and options. Each one cited. Sources checked 2026-11-12. HTML: https://unstale.sh/npm/@tiptap/extension-list/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @tiptap/extension-list 3

### Breaking changes

- Block elements immediately following ordered-list items now terminate the list as expected; indented bullets still nest, and indented thematic breaks are parsed as horizontal rules. (3.27.3) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3273)
- Headings after ordered list items, including indented headings inside list items, are parsed as real headings instead of plain text. (3.27.2) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3272)
- Adjacent ordered lists with different types are no longer merged. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3270)

### New APIs and options

- Adds a @tiptap/core helper that returns the block-level sibling before the cursor's textblock, or null at the first child of the block parent. (3.30.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3300)

### Behavior and default changes

- Tab at the start of a top-level textblock immediately after a list sinks that paragraph into the list's last item, subject to the stated cursor and selection conditions. (3.30.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3300)
- Plain-text paste detects typed ordered-list markers and converts them to the correct list type. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3270)

### Fixes and other changes

- Block math following an ordered list item without a blank line is parsed as block math, both after the list and indented inside the item, rather than being pulled into the item's text. (3.30.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3300)
- The checkbox label now also fills the wrapping label element, preventing accessibility audits from flagging it as empty. (3.30.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3300)
- Markdown parsing no longer treats a number followed by ) mid-line as an ordered list marker, preventing phone numbers like (216) 555-1234 from being parsed as lists. (3.28.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3280)
- Plain bullets nested under a task-list parent are no longer silently dropped; remaining lines are lexed and kept as sibling blocks inside the parent task item. (3.27.4) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3274)
- Indented ordered-list items now retain inline formatting during markdown parsing instead of falling back to literal, unparsed content. (3.27.3) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3273)
- Fixes ordered list parsing so under-indented continuation lines preserve their first character. (3.27.1) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3271)
- Ordered lists preserve the HTML type attribute through the HTML round-trip, supporting alphabetical and Roman numeral markers. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3270)
- Pasting from external editors detects ordered-list style from the HTML type attribute and CSS list-style-type properties. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3270)
- Markdown parsing and serialization preserve typed ordered-list markers using the corresponding prefix. (3.27.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3270)
- Backspace at the start of a non-first list item lifts it out of its list first; a second Backspace merges its content into the previous item. (3.25.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3250)
- Deleting at the end of a list item with a branching nested sublist hoists nested items to the parent list instead of selecting and deleting them on the next keypress. (3.25.0) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3250)
- Fixes dependency installation after package updates caused peer dependency resolution conflicts. (3.22.4) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3224)
- Non-indented continuation lines immediately following an ordered list item, before a blank line, remain inside that item as lazy continuation. (3.22.4) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3224)
- Empty paragraphs serialize with natural blank-line spacing for the first paragraph in a run and   markers for subsequent empty paragraphs at the same level; parsing preserves them in JSON. (3.20.2) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3202)
- Fixed numbering for ordered lists with a non-default start value. (3.17.1) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3171)
- Fixes lost HTML attributes in TaskItem node view updates. (3.15.2) — [release notes](https://github.com/ueberdosis/tiptap/blob/db790a7c5a6009b0a94382e12e1a5e9c642e1660/packages/extension-list/CHANGELOG.md#3152)