npm / @tiptap/extension-list
@tiptap/extension-list
What changed in @tiptap/extension-list 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-12.
3 breaking1 new APIs and options2 behavior and defaults16 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@tiptap/extension-list 322 changes
Breaking changes 3
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.
Headings after ordered list items, including indented headings inside list items, are parsed as real headings instead of plain text.
Adjacent ordered lists with different types are no longer merged.
New APIs and options 1
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.
Behavior and default changes 2
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.
Plain-text paste detects typed ordered-list markers and converts them to the correct list type.
Fixes and other changes 16
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.
The checkbox label now also fills the wrapping label element, preventing accessibility audits from flagging it as empty.
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.
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.
Indented ordered-list items now retain inline formatting during markdown parsing instead of falling back to literal, unparsed content.
Fixes ordered list parsing so under-indented continuation lines preserve their first character.
Ordered lists preserve the HTML type attribute through the HTML round-trip, supporting alphabetical and Roman numeral markers.
Pasting from external editors detects ordered-list style from the HTML type attribute and CSS list-style-type properties.
Markdown parsing and serialization preserve typed ordered-list markers using the corresponding prefix.
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.
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.
Fixes dependency installation after package updates caused peer dependency resolution conflicts.
Non-indented continuation lines immediately following an ordered list item, before a blank line, remain inside that item as lazy continuation.
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.
Fixed numbering for ordered lists with a non-default start value.
Fixes lost HTML attributes in TaskItem node view updates.