@tiptap/extension-blockquote
3.34.0 · 13 Nov 2026MIT35.1M / weekRepositoryHomepagenpmAtom feed
212 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
3.34.0
13 Nov 2026Keep the caret at the join when Backspace merges a paragraph into the blockquote above it.
3.33.1
10 Nov 2026Deleting a text selection that spans the whole document no longer leaves the deleted text's marks active, so text typed into the emptied editor is no longer bold, linked or otherwise marked.
The first
goToNextResult()orgoToPreviousResult()after a new search now selects the highlighted first result instead of skipping it.yCursorPluginnow publishes alastSelectionawareness field with each collaborative field's latest selection and whether its editor is focused. Unlikecursor, it stays after the editor loses focus, so other clients can still read the selection.lastSelectionis now reserved and can't be used as the cursor field.
3.33.0
5 Nov 2026With
enableContentCheck: true, shared content that does not fit the editor schema now emitscontentErrorinstead of being deleted. The editor pauses editing and sends no changes until compatible content arrives, so read-only users no longer send repairs that the server rejects.If you use
enableContentCheckwith collaboration and want the editor to keep repairing invalid content, turn the content check off.Add the
onInvalidContentsync option. When it is set, shared content that does not fit the editor schema stays in the shared document instead of being deleted. The editor shows what it can, pauses editing and sends no changes until compatible content arrives.
3.32.3
5 Nov 2026Clearing formatting on a nested list now turns every level into paragraphs, and
clearNodes()works in a chain with other node commands.Stop removed resizable node views from responding to later editor updates.
Bubble menus now update correctly after IME input, including Korean text
@tiptap/core
Patch Changes
Clearing formatting on a nested list now turns every level into paragraphs, and
clearNodes()works in a chain with other node commands.Stop removed resizable node views from responding to later editor updates.
@tiptap/extension-bubble-menu
Patch Changes
Bubble menus now update correctly after IME input, including Korean text
@tiptap/extension-code-block-lowlight
Patch Changes
Fixed a performance issue where code highlighting updates were unnecessarily triggered by selection-only changes
@tiptap/extension-floating-menu
Patch Changes
Floating menus now update correctly after IME input, including Korean text
@tiptap/extension-link
Patch Changes
Pasting a link without a protocol now uses the
defaultProtocoloption instead of always falling back tohttp.
@tiptap/extensions
Patch Changes
The Placeholder extension no longer leaves placeholders behind on empty nodes after the cursor moves away when
includeChildrenis enabled.
@tiptap/react
Patch Changes
Fix a React warning when a command like
setContentcreates React node views from inside an effect.Fixed the cursor no longer following clicks after an editor inside a shadow root was unmounted and remounted.
@tiptap/vue-2
Patch Changes
Fixed the cursor no longer following clicks after an editor inside a shadow root was unmounted and remounted.
@tiptap/vue-3
Patch Changes
Fixed the cursor no longer following clicks after an editor inside a shadow root was unmounted and remounted.
@tiptap/y-tiptap
Minor Changes
Remove persistent position migrations to stop structural edits and undo or redo from adding migration history to collaborative documents. Saved relative positions no longer follow content that structural edits replace or move.
Existing migration entries are deleted when an editor opens and when later Yjs updates arrive. Yjs can reclaim their stored data when garbage collection is enabled. Document content and other shared data are unchanged. Upgrade all collaborating clients to stop older clients from writing new entries.
Documents that the server refuses to load need cleanup on the server before a client can repair them. With Yjs garbage collection disabled, deleting entries does not reclaim their stored data.
3.32.0
13 Oct 2026A literal
!directly before a link is now escaped when serializing to Markdown, so the link is no longer parsed back as an image.Update ProseMirror dependencies to their latest versions.
Fix
useEditorStateoverflowing the stack when a selector returns a value with circular references, such aseditor.stateafter one stored mark replaces another.
@tiptap/markdown
Patch Changes
A literal
!directly before a link is now escaped when serializing to Markdown, so the link is no longer parsed back as an image.
@tiptap/pm
Patch Changes
Update ProseMirror dependencies to their latest versions.
@tiptap/react
Patch Changes
Fix
useEditorStateoverflowing the stack when a selector returns a value with circular references, such aseditor.stateafter one stored mark replaces another.
@tiptap/core
Minor Changes
Add the
schemaSpeceditor option to use an external ProseMirror schema structure with local extension behavior.
Patch Changes
Fix list toggling between list types that use different item nodes. Nested lists are recursively converted when the target item schema supports nesting, and flattened into sibling items when it does not.
@tiptap/y-tiptap
Patch Changes
Keep relative text and node positions attached through structural edits, node moves, and undo or redo across collaborating clients.
Improve TypeScript definitions for document synchronization, shared cursors, undo, redo, and document conversions.
Improve collaboration performance and keep comments, highlights, caret positions, and remote caret details intact during remote edits.
Preserve shared content when a client cannot display its nodes or marks, and pause that client's editing until compatible content is available.
Headless document creation rejects empty content when the schema requires child nodes.
@tiptap/extension-collaboration
Patch Changes
Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
@tiptap/extension-collaboration-caret
Patch Changes
Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
@tiptap/extension-drag-handle
Patch Changes
Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
@tiptap/ai-toolkit
Patch Changes
Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
3.31.4
30 Sep 2026The mathematics extension no longer crashes the editor in older WebKit browsers and WKWebView.
Fix a
TypeErrorthrown when the source editor is destroyed right after dragging content into another editor.splitBlockno longer throwsTransformError: Inserted content deeper than insertion positionwhen the selection spans block boundaries (for example from the start of one paragraph into another block, or across an isolating node). The command now returnsfalsewhen the split is not possible.
@tiptap/extension-mathematics
Patch Changes
The mathematics extension no longer crashes the editor in older WebKit browsers and WKWebView.
@tiptap/core
Patch Changes
Fix a
TypeErrorthrown when the source editor is destroyed right after dragging content into another editor.splitBlockno longer throwsTransformError: Inserted content deeper than insertion positionwhen the selection spans block boundaries (for example from the start of one paragraph into another block, or across an isolating node). The command now returnsfalsewhen the split is not possible.Prevent extra CSS declarations from being rendered from editor content.
Atom block directives (
:::name {…} :::) indented by up to 3 spaces are now tokenized, matching CommonMark indentation rules for block constructs.Numeric HTML entities (
',') are now decoded when parsing markdown, instead of showing up as literal text in the editor.The editor element keeps
role="textbox"aftersetOptions()wheneditorProps.attributesis set. Before, a re-render in React replaced the default role with the user attributes. Attributes passed as a function now get the default role as well.Undoing an input rule restores the Markdown characters that triggered it when using Collaboration.
Bind
parseMarkdownandrenderMarkdownto the configured extension so hooks can readthis.optionsandthis.namewithout an Editor.Pressing Enter before the text of a checked task item now leaves the new empty item unchecked and the item with the text checked. Attributes declared with
keepOnSplit: falsenow reset on the new item, not on the one that keeps the text.Stop joinItemForward and joinItemBackward from joining across isolating nodes.
Node views without a
contentDOMno longer ignore selection mutations, so ProseMirror moves the caret back to a valid position when the browser places it inside the node view.
@tiptap/markdown
Patch Changes
Fix Markdown serialization of inline code containing backticks
Bind
parseMarkdownandrenderMarkdownto the configured extension so hooks can readthis.optionsandthis.namewithout an Editor.
@tiptap/extension-code
Patch Changes
Fix Markdown serialization of inline code containing backticks
@tiptap/extension-table
Patch Changes
Table cells exported to Markdown now escape literal pipe characters, so the cell content survives when the output is read back.
Multi-block table cells no longer leak a U+001F control character into Markdown.
Right-clicking a cell inside a multi-cell table selection no longer collapses that selection.
Prevent extra CSS declarations from being rendered from editor content.
Table cells and headers no longer render the default
colspan="1"androwspan="1"attributes. Cells that actually span still render them, matching how prosemirror-tables serializes spans.
@tiptap/extension-list
Patch Changes
Parsing large Markdown documents that contain ordered lists is much faster. A 578KB document went from about 19s to about 160ms.
@tiptap/extension-collaboration-caret
Patch Changes
Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-highlight
Patch Changes
Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-text-align
Patch Changes
Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-text-style
Patch Changes
Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-link
Patch Changes
Typing spaces after a link no longer extends the link, including multiple spaces inserted in one transaction. Formatting changes and undo/redo preserve existing linked whitespace.
@tiptap/react
Patch Changes
Fix Enter and Shift-Enter inside React node views on iOS and Android.
React and Vue now use matching menu extension versions when installed from a specific release.
@tiptap/static-renderer
Patch Changes
Render
<audio>and<video>with a closing tag instead of self-closing them, so browsers no longer nest the following content inside the first audio element.Rendering a node whose
renderHTMLreturns several nested child elements no longer adds stray commas between them in the HTML string output.
@tiptap/extension-collaboration
Patch Changes
Undoing an input rule restores the Markdown characters that triggered it when using Collaboration.
@tiptap/vue-2
Patch Changes
React and Vue now use matching menu extension versions when installed from a specific release.
@tiptap/vue-3
Patch Changes
React and Vue now use matching menu extension versions when installed from a specific release.
3.31.3
4 Sep 2026Fixed a bug which allowed potentially unsafe color values being sent by other clients. Those unsafe colors received from collaboration users are now ignored.
Fix a TypeScript error (TS2694) in the shipped type declarations when
skipLibCheckis turned off.
3.31.2
3 Sep 20263.31.1
3 Sep 2026Fix freezes in framework-based node views on iOS and Android
3.31.0
1 Sep 2026Align
selectedwith ProseMirror node selections by default, expose text selections throughselectionInside, and keepselectedOnTextSelectioncompatible.
3.30.6
31 Aug 2026Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.
Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.
Pasting a YouTube iframe without a
srcattribute no longer crashes the editor. The embed is kept without a source.
@tiptap/core
Patch Changes
Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.
@tiptap/extension-list
Patch Changes
Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.
@tiptap/extension-youtube
Patch Changes
Pasting a YouTube iframe without a
srcattribute no longer crashes the editor. The embed is kept without a source.
@tiptap/markdown
Patch Changes
Fix Markdown serialization of whitespace-only marked text.
@tiptap/react
Patch Changes
Reduce overhead in React node views on documents with many nodes.
3.30.5
26 Aug 2026Fix a denial-of-service risk where crafted block or inline Markdown attributes could consume excessive CPU and block the browser or server event loop.
3.30.4
26 Aug 2026Prevent untrusted HTML attributes from changing an object's prototype when merged with
mergeAttributes.
3.30.3
24 Aug 2026Unsetting one text style inside a blockquote no longer removes the other text styles in it.
YouTube live URLs (
/live/<id>) now embed the video.Fix JSX runtime to properly render nested sibling elements by spreading children arrays into DOMOutputSpec
@tiptap/extension-text-style
Patch Changes
Unsetting one text style inside a blockquote no longer removes the other text styles in it.
@tiptap/extension-youtube
Patch Changes
YouTube live URLs (
/live/<id>) now embed the video.
@tiptap/core
Patch Changes
Fix JSX runtime to properly render nested sibling elements by spreading children arrays into DOMOutputSpec
@tiptap/react
Patch Changes
Fix ReactNodeViewRenderer crash when contentComponent is not available
@tiptap/ai-toolkit
Minor Changes
Add the
AiInsertRevealextension (@tiptap/ai-toolkit/streaming-reveal) to fade in text as the AI streams it into a collaborative document.
3.30.2
18 Aug 2026Keep mixed JSX children as separate siblings in DOM output.
Fixed a bug where
editor.chainandeditor.cancan not be accessed on editor initializationFix resizable images staying hidden when the image is cached or fails to load.
3.30.1
13 Aug 2026Fixed table markdown pipe escaping so the extension loads on older Safari and iOS versions (WebKit before Safari 16.4).
Added new ProseMirror helpers that check whether a value is a specific ProseMirror type.
3.30.0
11 Aug 2026Fixed Backspace freezing after merging a paragraph into a blockquote.
3.29.2
28 Jul 2026Fixed the caret jumping back to the previous block when pressing Enter inside a React node view.
Ensure only the active find-and-replace result keeps the current-result highlight while navigating matches.
3.29.1
27 Jul 2026Fix caret placement after splitting a block rendered with a React NodeView.
3.29.0
24 Jul 2026Add official RubyText extension for HTML ruby text annotations with non-editable annotations and mark-based document storage. The click-to-edit annotation editor can be replaced with a custom element via the
renderAnnotationEditoroption.Fix a TypeScript build error in
isAndroid()where comparingnavigator.platformagainst the literal'Android'with===could fail to compile under somelib.dom.d.tstypings ("types have no overlap"). Switched to the same.includes()pattern already used byisiOS(), which is not affected by this TypeScript narrowing issue. No runtime behavior change.Fixed a bug where deleting an
AllSelection(for example right after Ctrl/Cmd+A) left a lingering "phantom" selection highlight over the emptied document instead of a text cursor.deleteSelectionnow collapses the selection to a cursor.
@tiptap/extension-ruby-text
Minor Changes
Add official RubyText extension for HTML ruby text annotations with non-editable annotations and mark-based document storage. The click-to-edit annotation editor can be replaced with a custom element via the
renderAnnotationEditoroption.
@tiptap/core
Patch Changes
Fix a TypeScript build error in
isAndroid()where comparingnavigator.platformagainst the literal'Android'with===could fail to compile under somelib.dom.d.tstypings ("types have no overlap"). Switched to the same.includes()pattern already used byisiOS(), which is not affected by this TypeScript narrowing issue. No runtime behavior change.Fixed a bug where deleting an
AllSelection(for example right after Ctrl/Cmd+A) left a lingering "phantom" selection highlight over the emptied document instead of a text cursor.deleteSelectionnow collapses the selection to a cursor.Fix input rules crashing when the matched text spans an inline atom node like a mention.
Node view
getPos()now returnsundefinedinstead of throwing when the position cannot be resolved yet, for example when React 19 renders a node view component while the editor view is still updating.Fixed
onContentErrorthrowing when callingeditor.commandsfrom inside the handler on initial load with invalid content. The editor now has a usable state (seeded from the stripped fallback document) beforeonContentErrorfires.Fix
editor.$pos()returning the wrong node inside container nodes, for example the list item instead of the list.Add
insertDefaultBlockto insert the default textblock allowed at a position. It accepts an optional position, attributes, content, and selection-update option.
@tiptap/extension-find-and-replace
Minor Changes
Added a new
@tiptap/extension-find-and-replaceextension. It searches the document for a term, highlights all matches with decorations, and replaces the current or all matches. Supports case-sensitive, whole-word, and RE2-compatible regex search, plus commands to jump between results. Regex search avoids catastrophic backtracking but does not support lookarounds or backreferences.
@tiptap/pm
Patch Changes
Bump
prosemirror-modelto^1.25.11, fixing pasting content copied from the editor inserting extra empty paragraphs (a regression introduced inprosemirror-view1.42.0).
@tiptap/extension-hard-break
Patch Changes
Fixed a bug where inserted hard breaks would not scroll the view on insertion via commands.
@tiptap/extension-code-block
Patch Changes
Fixed a bug where pressing
ArrowUpin a code block that is the first node in the document did nothing, leaving no way to insert content above it. A new default block is now inserted above the code block, mirroring the existingArrowDownbehavior. The behavior can be disabled via the newexitOnArrowUpoption.
@tiptap/extension-table
Patch Changes
Fix inserting a table with an empty cell or header (e.g. via
insertContent/insertContentAt) throwingRangeError: Invalid content for node tableCell/tableHeader: <>. Empty<td>/<th>elements are now backfilled with the cell's default block content, matching the behavior you already get fromsetContent.Keep line breaks inside table cells when serializing to markdown. Hard breaks and paragraph breaks in a cell are now written as
<br>instead of being collapsed into a space, so they survive a parse/serialize round trip.
@tiptap/markdown
Patch Changes
Fixed blank lines being dropped after block elements (headings, tables, etc.) when parsing markdown. Blank lines were being absorbed into the block token instead of being preserved, causing content to lose a blank line on each parse/serialize cycle.
@tiptap/react
Patch Changes
Fixed
useEditorStatenot re-rendering components wheneditor.setEditable()changes the editor's editable state, since that call only emits anupdateevent and never atransaction.
@tiptap/vue-3
Patch Changes
Fix
<node-view-content as="tbody">(and similar restricted-content elements) rendering with an extra wrapper<div>nested inside them, which broke tables in Vue node views. Note: keep<node-view-content>mounted (usev-show, notv-if) — conditionally remounting it can leave ProseMirror attached to the old element.
@tiptap/extension-image
Patch Changes
Fix resizable images not synchronizing rendered attributes after updates
@tiptap/static-renderer
Patch Changes
Fix Markdown table serialization for merged cells by preserving the correct column layout for rowspan and colspan.
@tiptap/extension-link
Minor Changes
Typing or pasting Markdown link syntax like
[Tiptap](https://tiptap.dev)or[Tiptap](https://tiptap.dev "Rich text editor")can now automatically be converted into a link. The behavior is opt-in, enable it with the newmarkdownLinksoption.
3.28.0
15 Jul 2026Fix the cursor moving to the details summary after typing in content at the start of a document.
Fix markdown parsing a line like
(216) 555-1234as an ordered list. A number followed by)mid-line is no longer treated as a list marker.Batch React node view portal store notifications that happen in the same microtask to avoid nested update depth warnings when many node views mount together.
@tiptap/extension-details
Patch Changes
Fix the cursor moving to the details summary after typing in content at the start of a document.
@tiptap/extension-list
Patch Changes
Fix markdown parsing a line like
(216) 555-1234as an ordered list. A number followed by)mid-line is no longer treated as a list marker.
@tiptap/react
Patch Changes
Batch React node view portal store notifications that happen in the same microtask to avoid nested update depth warnings when many node views mount together.
Bind onMount and onUnmount event handlers when initializing an Editor with useEditor hook.
@tiptap/extension-collaboration-caret
Patch Changes
Bump @tiptap/y-tiptap version to ensure users use latest version
@tiptap/extension-collaboration
Patch Changes
Bump @tiptap/y-tiptap version to ensure users use latest version
@tiptap/extension-drag-handle
Patch Changes
Bump @tiptap/y-tiptap version to ensure users use latest version
@tiptap/extension-youtube
Minor Changes
Allow string
widthandheightvalues like'100%'or'20rem'in the YouTube extension. Non-numeric values in parsed HTML are now preserved instead of being converted to numbers.
3.27.4
13 Jul 2026Fix a crash when pressing backspace at the very start of the document with a leading image. The blockquote backspace handler dereferenced an undefined parent at the top (doc) level, throwing
TypeError: Cannot read properties of undefined (reading 'type'). It now bails out so backspace is a no-op at the document start.Add
@tiptap/pmas a peer dependency so bundlers resolve ProseMirror packages from the app instead of duplicatingprosemirror-modelinside@tiptap/extension-blockquote.
@tiptap/extension-blockquote
Patch Changes
Fix a crash when pressing backspace at the very start of the document with a leading image. The blockquote backspace handler dereferenced an undefined parent at the top (doc) level, throwing
TypeError: Cannot read properties of undefined (reading 'type'). It now bails out so backspace is a no-op at the document start.Add
@tiptap/pmas a peer dependency so bundlers resolve ProseMirror packages from the app instead of duplicatingprosemirror-modelinside@tiptap/extension-blockquote.
3.27.3
7 Jul 2026Fix
deleteSelectionto delete content across all selection ranges instead of only the first range. This restores multi-cell table selections and other custom selections with multiple ranges.Fix markdown parsing bugs where block elements right after an ordered list item (with no blank line in between) were wrongly treated as lazy continuation of the list item, instead of terminating the list the way other markdown parsers do:
An indented
***/___inside item content is now also parsed as a horizontal rule inside the item instead of literal text. A---line directly below item paragraph text keeps its current behavior because it is a setext heading underline per CommonMark, not a thematic break.Fix indented ordered list items (e.g. one leading space before the marker, as happens when a top-level ordered list is itself nested inside another list) losing inline formatting during markdown parsing. The custom ordered-list markdown tokenizer built its nested structure with a hardcoded base indentation of 0, so an item whose actual indentation was non-zero never matched, causing the tokenizer to silently produce zero items and bail out — falling back to a path that left the item's content as literal, unparsed text instead of running it through inline tokenization (bold, italic, etc. were lost). The base indentation is now taken from the first collected item instead of being hardcoded.
@tiptap/core
Patch Changes
Fix
deleteSelectionto delete content across all selection ranges instead of only the first range. This restores multi-cell table selections and other custom selections with multiple ranges.
@tiptap/extension-list
Patch Changes
Fix markdown parsing bugs where block elements right after an ordered list item (with no blank line in between) were wrongly treated as lazy continuation of the list item, instead of terminating the list the way other markdown parsers do:
Thematic breaks (
---,***,___,* * *) were swallowed into the list item as literal paragraph text — along with every line after them. They now terminate the list and become a horizontal rule.Fenced code blocks (
```and~~~) were nested inside the list item. They now terminate the list and become a top-level code block.Unindented bullet markers (
- item) were nested inside the ordered list item. They now terminate the ordered list and start a new top-level bullet list. Indented bullets still nest inside the item as before.
An indented
***/___inside item content is now also parsed as a horizontal rule inside the item instead of literal text. A---line directly below item paragraph text keeps its current behavior because it is a setext heading underline per CommonMark, not a thematic break.Fix indented ordered list items (e.g. one leading space before the marker, as happens when a top-level ordered list is itself nested inside another list) losing inline formatting during markdown parsing. The custom ordered-list markdown tokenizer built its nested structure with a hardcoded base indentation of 0, so an item whose actual indentation was non-zero never matched, causing the tokenizer to silently produce zero items and bail out — falling back to a path that left the item's content as literal, unparsed text instead of running it through inline tokenization (bold, italic, etc. were lost). The base indentation is now taken from the first collected item instead of being hardcoded.
@tiptap/extensions
Patch Changes
Fixed placeholder flickering and disappearance on large documents. Replaced the viewport-based decoration scan with an incremental
StateField<DecorationSet>that only re-computes decorations for top-level nodes touched by each transaction. This eliminates the dependency on DOM measurement (posAtCoords),requestAnimationFramescheduling, and scroll listeners that caused flickering under collaboration, occlusion, and rapid edits.
3.27.2
6 Jul 2026Fix arrow key navigation past emoji nodes in Firefox. Previously, pressing ArrowLeft with the cursor adjacent to an inline non-selectable emoji node at a paragraph boundary would not move the cursor in Firefox. The cursor now correctly skips over emoji nodes in both directions.
Add
consumePasteEventoption to the file-handler extension. Whentrue,handlePastereturnstrueeven when HTML content is present in the clipboard, preventing paste rules from other extensions from creating duplicate content. Default isfalse.Fix NodeRangeSelection not being restored after drag-and-drop when Collaboration (Yjs) is enabled. Drop anchor positions are now tracked with Yjs relative positions and remapped across
isChangeOrigindocument rebuilds, and selection restore runs viaappendTransactionafter the drop transaction settles.
@tiptap/extension-emoji
Patch Changes
Fix arrow key navigation past emoji nodes in Firefox. Previously, pressing ArrowLeft with the cursor adjacent to an inline non-selectable emoji node at a paragraph boundary would not move the cursor in Firefox. The cursor now correctly skips over emoji nodes in both directions.
@tiptap/extension-file-handler
Patch Changes
Add
consumePasteEventoption to the file-handler extension. Whentrue,handlePastereturnstrueeven when HTML content is present in the clipboard, preventing paste rules from other extensions from creating duplicate content. Default isfalse.
@tiptap/extension-drag-handle
Patch Changes
Fix NodeRangeSelection not being restored after drag-and-drop when Collaboration (Yjs) is enabled. Drop anchor positions are now tracked with Yjs relative positions and remapped across
isChangeOrigindocument rebuilds, and selection restore runs viaappendTransactionafter the drop transaction settles.Fix the drag handle when the editor renders zero-size widget decorations, such as the page chrome injected by the Pages extension. The handle now resolves to the correct block instead of failing to position or aligning to a decoration, and it stays above positioned page chrome so it remains clickable.
@tiptap/extension-link
Patch Changes
Coerce
undefinedHTMLAttributes (target,rel,class) tonullso ProseMirror does not emit "No value supplied for attribute" warnings when these options are explicitly set toundefined.
@tiptap/extension-list
Patch Changes
Fix a markdown parsing bug where a heading right after an ordered list item (with no blank line in between) got pulled into the list item as plain text, so you'd see a literal
###inside the list instead of an actual heading. Headings now end the list and get parsed properly, the way other markdown parsers handle it. Indented headings inside a list item are also parsed as real headings now instead of literal text.
@tiptap/extension-mathematics
Patch Changes
Allow KaTeX 0.17
@tiptap/react
Patch Changes
Change prop types of the Tiptap component so that either the
editoror theinstancefields are required
@tiptap/extension-drag-handle-react
Patch Changes
Fix React 19 strict mode compatibility by using useRef instead of useState for the portal element. Changing the
classNameprop now updates the element in place without re-registering the drag handle plugin.
@tiptap/static-renderer
Patch Changes
Fix the static renderer ignoring
unhandledNodeandunhandledMarkfor node or mark types missing from the schema; such content now falls back to those renderers instead of throwing inNode.fromJSON
@tiptap/pm
Patch Changes
Updated all ProseMirror packages to the latest publicly available versions
3.27.1
18 Jun 2026Respect margin properties passed via
dragImagePropertieson the drag preview. The clone reset its margin to0after copying styles, which discarded any margin the user explicitly requested. The reset now runs only when no margin property is listed indragImageProperties, so the drag image can keep the same spacing as the live block.Fix ordered list parsing so under-indented continuation lines preserve their first character.
Fix Placeholder flickering while a modal overlay is open. When the editor was occluded during a stream of transactions (e.g. remote collaboration edits), the viewport measurement fell back to a full-document range and repeatedly toggled the
data-placeholderattribute on empty blocks. The viewport window is now frozen when the editor can't be measured reliably, so placeholders stay stable.
@tiptap/extension-drag-handle
Patch Changes
Respect margin properties passed via
dragImagePropertieson the drag preview. The clone reset its margin to0after copying styles, which discarded any margin the user explicitly requested. The reset now runs only when no margin property is listed indragImageProperties, so the drag image can keep the same spacing as the live block.
@tiptap/extension-list
Patch Changes
Fix ordered list parsing so under-indented continuation lines preserve their first character.
@tiptap/extensions
Patch Changes
Fix Placeholder flickering while a modal overlay is open. When the editor was occluded during a stream of transactions (e.g. remote collaboration edits), the viewport measurement fell back to a full-document range and repeatedly toggled the
data-placeholderattribute on empty blocks. The viewport window is now frozen when the editor can't be measured reliably, so placeholders stay stable.
3.27.0
17 Jun 2026Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.parseAttributesnow supports any word characters at the start of classes or id attributes.
@tiptap/extension-list
Minor Changes
Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:type="a"→ lowercase alphabetical markerstype="A"→ uppercase alphabetical markerstype="i"→ lowercase roman numeral markerstype="I"→ uppercase roman numeral markers
Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.
@tiptap/core
Patch Changes
Ordered lists now support the
typeattribute (a,A,i,I).The
<ol>typeattribute is now fully preserved through the HTML round-trip:type="a"→ lowercase alphabetical markerstype="A"→ uppercase alphabetical markerstype="i"→ lowercase roman numeral markerstype="I"→ uppercase roman numeral markers
Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML
typeattribute and from CSSlist-style-typeproperties.Plain text paste of typed ordered list markers (e.g.
a. Item,I) Item,i. Item\nii. Item) is detected and converted to the correct list type.Markdown round-trip preserves typed markers: parsing
a. Itemcreatestype: "a", and serializing a typed list back to markdown uses the correct prefix (e.g.I.,ii.).Joining of adjacent lists now respects
type— two lists with different types (e.g. default numeric andtype="a") are not merged.parseAttributesnow supports any word characters at the start of classes or id attributes.Fix
marksEqualto compare mark arrays as multisets instead of index-by-index, so order of marks no longer affects the result. Broaden the type signature to accept ProseMirrorMarkobjects (wheretypeis an object with anameproperty) alongside the existing JSON mark shape ({ type: string }).Fix a edge-case in
rewriteUnknownContentto not fail on null-ish values inside marks or nodes.
@tiptap/extension-link
Patch Changes
Fix
isAllowedUriaccepting unknown protocols whose name contains a hyphen (e.g.unknown-protocol://test). The hyphen is a valid scheme character per RFC 3986, but the regex was built from a template literal where\-collapsed to-, leaving the terminator class[^a-z+.-:]to parse.-:as a character range that excluded0-9and/rather than-. With the proper double-escape, the regex correctly excludes-and unknown hyphenated schemes are rejected again.
@tiptap/suggestion
Minor Changes
Add
props.mount(element)for fully managed popup positioning. It mounts the popup into the configuredcontainer(defaultdocument.body), keeps it anchored to the cursor, and automatically repositions on scroll, resize, and layout shifts via Floating UI'sautoUpdate— no manual listeners required. It returns anunmountfunction to call inonExit.This is additive and opt-in: mounting and positioning manually with
props.floatingUi+props.clientRectremains supported as an escape hatch.Dismiss managed suggestion popups when the user clicks outside both the popup and the editor. Enabled by default for popups mounted via
props.mount, and configurable with the newdismissOnOutsideClickoption.Expose Floating UI positioning configuration through
SuggestionProps. Consumers can now readplacement,offset,flip,container, and a resolvedfloatingUiconfig to drive their own positioning loop.Add async suggestion lifecycle handling, including debounced async
items(), in-flight request aborting,initialItems, aloadingstate, and aminQueryLengthfilter.
@tiptap/markdown
Patch Changes
Fix parsing with injected Marked instances so custom markdown tokenizers registered via
marked.use(...)are respected.Fix unrecognized HTML detection during markdown parsing to work without
window.DOMParserorHTMLUnknownElement, so angle-bracket placeholders are preserved as literal text in SSR and Node environments.
@tiptap/extension-drag-handle
Patch Changes
Fix multi-block drags only removing the first block when nested mode is enabled
3.26.1
11 Jun 2026Fixed drag-and-drop duplicating blocks during collaboration. When a remote collaborator edited the document mid-drag, dropping left an empty copy of the dragged block at its original position. This fix also requires a version of
@tiptap/y-tiptapthat restores node range selections across remote updates.Restore the node range selection after dragging multiple blocks. Previously, dropping a multi-block drag left a text selection inside the moved content instead of keeping the dragged blocks selected.
@tiptap/extension-node-range
Patch Changes
Fixed drag-and-drop duplicating blocks during collaboration. When a remote collaborator edited the document mid-drag, dropping left an empty copy of the dragged block at its original position. This fix also requires a version of
@tiptap/y-tiptapthat restores node range selections across remote updates.Bump
@tiptap/y-tiptapto version ^3.0.5
@tiptap/extension-drag-handle
Patch Changes
Restore the node range selection after dragging multiple blocks. Previously, dropping a multi-block drag left a text selection inside the moved content instead of keeping the dragged blocks selected.
Bump
@tiptap/y-tiptapto version ^3.0.5
@tiptap/extension-collaboration-caret
Patch Changes
Bump
@tiptap/y-tiptapto version ^3.0.5
@tiptap/extension-collaboration
Patch Changes
Bump
@tiptap/y-tiptapto version ^3.0.5
3.26.0
5 Jun 2026Backspace at the start of a non-first child of a blockquote now lifts that child out, splitting the blockquote around it. A second backspace at the start of a top-level textblock whose previous sibling is a blockquote merges the textblock's inline content into the blockquote's last textblock instead of pulling the paragraph back inside.
@tiptap/extension-blockquote
Minor Changes
Backspace at the start of a non-first child of a blockquote now lifts that child out, splitting the blockquote around it. A second backspace at the start of a top-level textblock whose previous sibling is a blockquote merges the textblock's inline content into the blockquote's last textblock instead of pulling the paragraph back inside.
3.25.0
3 Jun 2026Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.Add
clearablemark option (defaulttrue).unsetAllMarksnow skips marks withclearable: false, so semantic marks like comments are not removed by "clear formatting".Add
attrsEqualandmarksEqualutility functions to@tiptap/core.attrsEqualcompares two attribute objects for equality regardless of key ordering.marksEqualcompares two arrays of mark objects by type and attributes usingattrsEqual.
@tiptap/core
Patch Changes
Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.Add
clearablemark option (defaulttrue).unsetAllMarksnow skips marks withclearable: false, so semantic marks like comments are not removed by "clear formatting".Add
attrsEqualandmarksEqualutility functions to@tiptap/core.attrsEqualcompares two attribute objects for equality regardless of key ordering.marksEqualcompares two arrays of mark objects by type and attributes usingattrsEqual.Fix plain-text copy of table cell selections including content from unselected cells in between. Each selected range is now serialized independently and joined in document order, so dragging upward (reverse selection) also produces output in document order.
@tiptap/extension-file-handler
Patch Changes
Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.
@tiptap/extension-image
Patch Changes
Dragging an inline/resizable image within the editor no longer creates a duplicate
When the
Imageextension was configured withinline: trueorresizeenabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populatedataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.Fix
HTMLAttributesnot being applied to the editor DOM whenresizeis enabled. TheaddNodeViewpath was using only the resolved node attributes and skipping the user-configuredHTMLAttributesoption. Now it merges them consistently with howrenderHTMLalready works.
@tiptap/extension-list
Minor Changes
ListKeymap's Backspace handler now lifts the current list item before merging. At the start of a non-first list item, the item is lifted out of its wrapping list (splitting the list around it) instead of immediately joining its content into the previous item. A second Backspace then hits the existing "paragraph after a list" branch and merges the lifted textblock's content into the previous list's last item. Mirrors the two-step behavior introduced for blockquote in #7891.
Patch Changes
Fix delete at the end of a list item with a branching nested sublist. Nested items are hoisted to the parent list instead of being node-selected and deleted on the next keypress.
@tiptap/extensions
Minor Changes
Allow
emptyNodeClassin the Placeholder extension to accept a function that returns a dynamic CSS class name per node
@tiptap/static-renderer
Patch Changes
Fix blockquote markdown rendering to add a trailing newline so subsequent content is not incorrectly included in the blockquote
Fix the types of the JSON static renderers (
renderJSONContentToReactElementandrenderJSONContentToString): you can now passJSONContentdirectly and read node fields likenode.textin your mappings without type errors or casts.
@tiptap/extension-table
Patch Changes
Fix
HTMLAttributesnot being applied to the<table>element whenresizableis disabled (the default). TheTableViewnode view (introduced in 3.23) bypassedrenderHTMLand never applied user-configured attributes likeclassordata-*to the rendered table element.
@tiptap/pm
Patch Changes
Bump
prosemirror-tablesto^1.8.0sofindTableis available from@tiptap/pm, and align the related ProseMirror dependencies with the versions required byprosemirror-tables.
@tiptap/extension-unique-id
Patch Changes
Fix memory leak when destroying an editor before the collaboration provider syncs. The
syncedlistener registered inonCreatewas only removed once the event fired, so destroying the editor first left thecreateIdsclosure (and the whole editor it captures) referenced by the shared provider. The listener is now also detached on destroy, so the editor can be garbage collected.
@tiptap/extension-code
Patch Changes
Fixed a bug where typing a character before an inline code markdown shortcut (e.g.
afollowed by backtick-delimited code) would delete the preceding character. The preceding character is now preserved.
@tiptap/extension-collaboration-caret
Patch Changes
Fix crash when awareness state value is null or undefined (e.g. after a client disconnects)
@tiptap/extension-collaboration
Patch Changes
Fixed
onContentErrornot being triggered when invalid collaborative content is detected. ThefilterTransactionhook now allows the transaction through to keep ProseMirror state in sync with Yjs, ensuring thecontentErrorevent fires correctly.
@tiptap/markdown
Patch Changes
Fix backslash-escape handling in the Markdown parser and serializer. Parsing a backslash-escaped markdown character (e.g.
\*,\_,\\) now correctly produces a literal text node, instead of silently dropping the character. On serialization, characters that have special meaning in markdown inline syntax (*,_,`,[,],\,~) are now backslash-escaped in non-code text nodes to prevent them from being misinterpreted as formatting delimiters when the output is parsed again.
@tiptap/vue-3
Patch Changes
Fix
VueNodeViewRendererthrashing the DOM whencontentDOMis null for non-leaf nodes. The renderer now always creates a contentDOM element for non-leaf nodes (matching React's behavior), so ProseMirror has a valid element to render children into even when the NodeView component does not includeNodeViewContentor renders it conditionally.
@tiptap/vue-2
Patch Changes
Fix
VueNodeViewRendererthrashing the DOM whencontentDOMis null for non-leaf nodes. The renderer now always creates a contentDOM element for non-leaf nodes (matching React's behavior), so ProseMirror has a valid element to render children into even when the NodeView component does not includeNodeViewContentor renders it conditionally.
3.24.0
29 May 2026Fix memory leak when destroying an editor while the collaboration provider stays alive (e.g. multiple editors sharing one provider). The extension's awareness
updatelistener is now removed on destroy, so the editor can be garbage collected.Fix a memory leak where destroying an editor while its Y.Doc/provider stays alive (e.g. multiple editors sharing one provider) left the editor uncollectable. Yjs' UndoManager registered a
doc.on('destroy', ...)listener that was never removed, keeping the UndoManager — and through it the whole editor — reachable from the long-lived doc. Fixed upstream in@tiptap/y-tiptap; this bumps the dependency to pull in the fix.Exclude
toTextproperty when serializing the schema into a JSON object, because it is a function and functions are not serializable.
@tiptap/extension-collaboration-caret
Patch Changes
Fix memory leak when destroying an editor while the collaboration provider stays alive (e.g. multiple editors sharing one provider). The extension's awareness
updatelistener is now removed on destroy, so the editor can be garbage collected.
@tiptap/extension-collaboration
Patch Changes
Fix a memory leak where destroying an editor while its Y.Doc/provider stays alive (e.g. multiple editors sharing one provider) left the editor uncollectable. Yjs' UndoManager registered a
doc.on('destroy', ...)listener that was never removed, keeping the UndoManager — and through it the whole editor — reachable from the long-lived doc. Fixed upstream in@tiptap/y-tiptap; this bumps the dependency to pull in the fix.
@tiptap/server-ai-toolkit
Patch Changes
Exclude
toTextproperty when serializing the schema into a JSON object, because it is a function and functions are not serializable.
@tiptap/pm
Patch Changes
Add missing
@tiptap/pm/inputrulesexport
@tiptap/extension-details
Patch Changes
Fix persisted details toggles when the details node is at the start of the document.
@tiptap/markdown
Patch Changes
Fix text inside unknown angle-bracket tags being silently swallowed during markdown parsing. HTML-like content such as
<enter existing CID here if available>that does not map to any known element is now preserved as literal text instead of disappearing, which also prevents downstreamcontentMatchAterrors when complex schemas (Mention, Variable, Table) are in use.
@tiptap/static-renderer
Patch Changes
Honor the
textDirectioneditor option inrenderToHTMLString,renderToMarkdown, andrenderToReactElement, and omitnull/undefinedattribute values instead of serializing them as the literal string"null".
@tiptap/extensions
Patch Changes
Fix placeholder flickering during collaborative editing and reduce scroll-time CPU usage by deferring viewport recomputation to rAF, adding an overscan margin, and throttling scroll updates
@tiptap/extension-table-of-contents
Minor Changes
Add
generateTocIds, a server-side utility that assignsidanddata-toc-idattributes to anchor nodes in a Tiptap JSON document without needing anEditorinstance.
3.23.6
21 May 2026DragHandle: Added
dragImagePropertiesoption to limit which CSS properties are cloned for the drag image. By default all ~300+ computed styles are copied; setting this to a subset (e.g.['color', 'background-color', 'font-size']) reduces the cost when dragging selections with complex nodes.Fix deleteSelection to properly handle inline nodes with
text*content. The selection is now expanded to include the entire inline node boundaries when deleting, preventing incorrect collapse of inline text nodes.Placeholder: Replaced full-document
doc.descendants()traversal with a cursor-resolved fast path for the default config and viewport-limited scanning for the non-default config, significantly reducing decoration overhead on large documents.
@tiptap/extension-drag-handle
Patch Changes
DragHandle: Added
dragImagePropertiesoption to limit which CSS properties are cloned for the drag image. By default all ~300+ computed styles are copied; setting this to a subset (e.g.['color', 'background-color', 'font-size']) reduces the cost when dragging selections with complex nodes.
@tiptap/core
Patch Changes
Fix deleteSelection to properly handle inline nodes with
text*content. The selection is now expanded to include the entire inline node boundaries when deleting, preventing incorrect collapse of inline text nodes.
@tiptap/extensions
Patch Changes
Placeholder: Replaced full-document
doc.descendants()traversal with a cursor-resolved fast path for the default config and viewport-limited scanning for the non-default config, significantly reducing decoration overhead on large documents.
3.23.5
19 May 2026Fix extra mark tokens after inline atom nodes during Markdown serialization
Fix adjacent marks of the same type with different attributes being merged during Markdown serialization
Fix $pos() returning correct node for non-text atom nodes instead of doc node
@tiptap/markdown
Patch Changes
Fix extra mark tokens after inline atom nodes during Markdown serialization
Fix adjacent marks of the same type with different attributes being merged during Markdown serialization
@tiptap/core
Patch Changes
Fix $pos() returning correct node for non-text atom nodes instead of doc node
nodeview: Eliminate unnecessary re-renders, add opt-in position tracking
NodeViews no longer re-render when decorations or position change without
content changes. AddedtrackNodeViewPositionoption — when enabled, the
component re-renders on every position shift so calls togetPos()stay
current in render output. Removed the internalnodeViewPositionRegistry.
Added shallow prop comparison inReactRenderer.updateProps().
@tiptap/react
Patch Changes
Respect explicit
immediatelyRender: truein client-side Next.js. Previously, when running under Next.js (window.nextpresent), theimmediatelyRenderoption was forced tofalseeven when the user explicitly passedtrue, breaking client-only Next.js apps that rely on the editor existing on the first render. The hook now only forcesfalsewhen actual SSR is detected (typeof window === 'undefined'), or when running under Next.js with no explicit value.nodeview: Eliminate unnecessary re-renders, add opt-in position tracking
NodeViews no longer re-render when decorations or position change without
content changes. AddedtrackNodeViewPositionoption — when enabled, the
component re-renders on every position shift so calls togetPos()stay
current in render output. Removed the internalnodeViewPositionRegistry.
Added shallow prop comparison inReactRenderer.updateProps().
@tiptap/vue-2
Patch Changes
nodeview: Eliminate unnecessary re-renders, add opt-in position tracking
NodeViews no longer re-render when decorations or position change without
content changes. AddedtrackNodeViewPositionoption — when enabled, the
component re-renders on every position shift so calls togetPos()stay
current in render output. Removed the internalnodeViewPositionRegistry.
Added shallow prop comparison inReactRenderer.updateProps().
@tiptap/vue-3
Patch Changes
nodeview: Eliminate unnecessary re-renders, add opt-in position tracking
NodeViews no longer re-render when decorations or position change without
content changes. AddedtrackNodeViewPositionoption — when enabled, the
component re-renders on every position shift so calls togetPos()stay
current in render output. Removed the internalnodeViewPositionRegistry.
Added shallow prop comparison inReactRenderer.updateProps().
@tiptap/extension-drag-handle-react
Patch Changes
Fix missing forwarding of getReferencedVirtualElement in DragHandle React component
3.23.4
13 May 2026Add a new
autoTrimoption toCharacterCountwhich can be used to allow exceeding the character limit and either trim or validate the content length manually
3.23.2
12 May 2026Fix Twitch and YouTube embeds losing their canonical video, clip, channel, or playlist URL when HTML content is loaded back into the editor.
Fix Twitch and YouTube embeds losing their canonical video, clip, channel, or playlist URL when HTML content is loaded back into the editor.
Fix
"HTML entity encoding ingetHTML()output for inline style attributes. Adds agetStylePropertyutility to@tiptap/coreand migratesColor,BackgroundColor,FontFamily,FontSize,LineHeight, andHighlightextensions to use it
@tiptap/extension-twitch
Patch Changes
Fix Twitch and YouTube embeds losing their canonical video, clip, channel, or playlist URL when HTML content is loaded back into the editor.
@tiptap/extension-youtube
Patch Changes
Fix Twitch and YouTube embeds losing their canonical video, clip, channel, or playlist URL when HTML content is loaded back into the editor.
@tiptap/core
Patch Changes
Fix
"HTML entity encoding ingetHTML()output for inline style attributes. Adds agetStylePropertyutility to@tiptap/coreand migratesColor,BackgroundColor,FontFamily,FontSize,LineHeight, andHighlightextensions to use it
@tiptap/extension-text-style
Patch Changes
Fix
"HTML entity encoding ingetHTML()output for inline style attributes. Adds agetStylePropertyutility to@tiptap/coreand migratesColor,BackgroundColor,FontFamily,FontSize,LineHeight, andHighlightextensions to use it
@tiptap/extension-highlight
Patch Changes
Fix
"HTML entity encoding ingetHTML()output for inline style attributes. Adds agetStylePropertyutility to@tiptap/coreand migratesColor,BackgroundColor,FontFamily,FontSize,LineHeight, andHighlightextensions to use it
@tiptap/react
Patch Changes
Default
immediatelyRendertofalsein SSR environments instead of throwing an errorPreviously, omitting
immediatelyRenderin an SSR environment (e.g. Next.js) would throw an error in development and silently returnnullin production. This was a common source of crashes, especially when AI-generated code set up the editor without explicitly passingimmediatelyRender: false. The hook now defaultsimmediatelyRendertotrue, but automatically sets it tofalsewhen SSR is detected, logging a warning in development instead of throwing.
@tiptap/vue-3
Patch Changes
Fix a
useEditorunmount crash by avoiding replacement of Vue-managed DOM nodes during teardown.
@tiptap/server-ai-toolkit
Minor Changes
Initial open-source release of the Server AI Toolkit package
3.22.5 – 3.23.12 releases that only update dependencies@tiptap/core 3.23.1Show each
- 3.23.18 May 2026@tiptap/core 3.23.1
- 3.22.528 Apr 2026@tiptap/core 3.22.5
3.22.4
18 Apr 2026Fix dependencies installation after packages updates producing peer dependency resolution conflicts
@tiptap/extension-blockquote
Patch Changes
Fix dependencies installation after packages updates producing peer dependency resolution conflicts
3.22.3
8 Apr 2026Fixed
insertContentAtcorrupting the document when inserting inline content with marks at the start of a paragraph. Thefrom - 1position adjustment now only applies to block-level content.Add an option to control whether node ranges extend when a selection only touches a node boundary.
Remove unnecessary
xmlns="http://www.w3.org/1999/xhtml"attribute fromgenerateHTMLoutput by usinginnerHTMLinstead ofXMLSerializerfor HTML serialization.
@tiptap/core
Patch Changes
Fixed
insertContentAtcorrupting the document when inserting inline content with marks at the start of a paragraph. Thefrom - 1position adjustment now only applies to block-level content.
@tiptap/extension-node-range
Patch Changes
Add an option to control whether node ranges extend when a selection only touches a node boundary.
@tiptap/html
Patch Changes
Remove unnecessary
xmlns="http://www.w3.org/1999/xhtml"attribute fromgenerateHTMLoutput by usinginnerHTMLinstead ofXMLSerializerfor HTML serialization.
@tiptap/extension-drag-handle
Patch Changes
Fix drag selections so crossing a node boundary does not incorrectly include the next node.
@tiptap/starter-kit
3.22.2
4 Apr 2026Fix incorrect selection placement when pasting at the end of a marked text node, ensuring inclusive marks are respected
Fixes list toggling when the entire document is selected
Add new transaction meta handlers to programmatically show & hide the floating & bubble menus via
transaction.setMeta('menuKey', 'show')andtransaction.setMeta('menuKey', 'hide')
@tiptap/core
Patch Changes
Fix incorrect selection placement when pasting at the end of a marked text node, ensuring inclusive marks are respected
Fixes list toggling when the entire document is selected
@tiptap/extension-floating-menu
Patch Changes
Add new transaction meta handlers to programmatically show & hide the floating & bubble menus via
transaction.setMeta('menuKey', 'show')andtransaction.setMeta('menuKey', 'hide')
@tiptap/extension-bubble-menu
Patch Changes
Add new transaction meta handlers to programmatically show & hide the floating & bubble menus via
transaction.setMeta('menuKey', 'show')andtransaction.setMeta('menuKey', 'hide')
@tiptap/extension-typography
Patch Changes
Added RTL smart quote support
@tiptap/react
Patch Changes
Fixed an error where
flushSync()would run in<EditorContent />lifecycle
@tiptap/extension-drag-handle-vue-3
Patch Changes
Fixed an issue causing drag handle visibility not to update dynamically in Vue 3 components.
@tiptap/starter-kit
3.22.1
2 Apr 2026Fixed drag handle ghost image for RTL and mixed-direction content: the ghost wrapper now uses the dragged block’s computed
direction(viadomAtPos), and the drag image hotspot uses the cursor position relative to the ghostwrapperso the preview aligns with the pointer in both LTR and RTL.Fix NodeView not re-rendering when a node's position changes without content or decoration changes (e.g. when a sibling node is moved within the same parent)
Don't stop dragover/dragenter events in NodeViews, to prevent spurious drag-copy cursors
@tiptap/extension-drag-handle
Patch Changes
Fixed drag handle ghost image for RTL and mixed-direction content: the ghost wrapper now uses the dragged block’s computed
direction(viadomAtPos), and the drag image hotspot uses the cursor position relative to the ghostwrapperso the preview aligns with the pointer in both LTR and RTL.
@tiptap/core
Patch Changes
Fix NodeView not re-rendering when a node's position changes without content or decoration changes (e.g. when a sibling node is moved within the same parent)
Don't stop dragover/dragenter events in NodeViews, to prevent spurious drag-copy cursors
@tiptap/react
Patch Changes
Fix NodeView not re-rendering when a node's position changes without content or decoration changes (e.g. when a sibling node is moved within the same parent)
Prevent React node views from crashing during deferred selection updates when ProseMirror has already detached the node view position lookup.
@tiptap/vue-3
Patch Changes
Fix NodeView not re-rendering when a node's position changes without content or decoration changes (e.g. when a sibling node is moved within the same parent)
@tiptap/vue-2
Patch Changes
Fix NodeView not re-rendering when a node's position changes without content or decoration changes (e.g. when a sibling node is moved within the same parent)
3.22.0
31 Mar 2026Use a named import for Suggestion from
@tiptap/suggestionto avoid bundler ESM/CJS interop
wrapping (__toESM) that caused CJS consumers to receive a module object instead of the
callable plugin factory.This is a non-breaking internal fix identical to the one applied to
@tiptap/extension-mention
in #6994.Moved content validation from Yjs
beforeTransaction(whose return value was ignored) to ProseMirrorfilterTransaction, so invalid collaborative changes are now properly blocked.Prevent hidden bubble menus from reappearing during scroll and resize updates. Bubble menu positioning now only runs for menus that are already shown, so default text-selection menus stay hidden until they should actually open.
@tiptap/extension-emoji
Patch Changes
Use a named import for Suggestion from
@tiptap/suggestionto avoid bundler ESM/CJS interop
wrapping (__toESM) that caused CJS consumers to receive a module object instead of the
callable plugin factory.This is a non-breaking internal fix identical to the one applied to
@tiptap/extension-mention
in #6994.
@tiptap/extension-collaboration
Patch Changes
Moved content validation from Yjs
beforeTransaction(whose return value was ignored) to ProseMirrorfilterTransaction, so invalid collaborative changes are now properly blocked.
@tiptap/extension-bubble-menu
Patch Changes
Prevent hidden bubble menus from reappearing during scroll and resize updates. Bubble menu positioning now only runs for menus that are already shown, so default text-selection menus stay hidden until they should actually open.
@tiptap/core
Patch Changes
Fix HTML character escaping in markdown roundtrip. HTML entities (
<,>,&,") are now decoded to literal characters when parsing markdown into the editor.<,>, and&are re-encoded when serializing back to markdown, while"is preserved as a literal character since double quotes are ordinary in markdown. Code detection for skipping encoding now uses thecode: trueextension spec instead of hardcoded type names. Literal characters inside code blocks and inline code are always preserved.Fix ResizableNodeView ignoring node's inline setting by using
inline-flexfor inline nodes andflexfor block nodesextendMarkRange defaults to using the attributes of the first mark of the given type, instead of
attributes = {}. In particular,extendMarkRange('link')no longer extends to adjacent links with different hrefs; restore the previous behavior withextendMarkRange('link', {}).Fix getMarkRange attributes default to consider the first mark of the given type
Guard mark delete event handling when
unsetMarkremoves a mark from inline content that starts at position0, preventing aRangeErrorduring the before-node lookup.
@tiptap/markdown
Patch Changes
Fix HTML character escaping in markdown roundtrip. HTML entities (
<,>,&,") are now decoded to literal characters when parsing markdown into the editor.<,>, and&are re-encoded when serializing back to markdown, while"is preserved as a literal character since double quotes are ordinary in markdown. Code detection for skipping encoding now uses thecode: trueextension spec instead of hardcoded type names. Literal characters inside code blocks and inline code are always preserved.
@tiptap/extension-mathematics
Patch Changes
Prevent inline math input rule from capturing previous character. Changed input rule to utilize negative lookbehind to prevent matching previous character. Ensures the range's
fromposition is correctly at the start of the double$signs.
@tiptap/suggestion
Patch Changes
Suggestions dismissed via Escape no longer reappear when the user keeps typing in the same word — they only come back after inserting whitespace, a newline, or moving the cursor to a different trigger.
@tiptap/extension-details
Patch Changes
Fix a rerender loop in the Details node view when the toggle button updates its DOM attributes through
renderToggleButton.
@tiptap/html
Patch Changes
Updated happy-dom to 20.8.9
@tiptap/extension-table
Minor Changes
Added Markdown table alignment support. The
TableCellandTableHeadernodes now have analignattribute (left,center,right) that is parsed from Markdown column alignment markers (:---,---:,:---:) and serialized back when rendering to Markdown. Alignment is also parsed from and rendered to HTML viastyle="text-align: ...".
3.21.0
27 Mar 2026Add a
renderToggleButtonoption to customize the details toggle button, including its accessible label.Fix custom markdown tokenizer helper lexing to use Marked's active lexer so ordered list parsing no longer breaks inline tokenization in following paragraphs.
Updated
findElementNextToCoordsto fall back toview.posAtCoordswhenelementsFromPointreturns no matching block, resolving the position to the top-level block node.
@tiptap/extension-details
Minor Changes
Add a
renderToggleButtonoption to customize the details toggle button, including its accessible label.
@tiptap/markdown
Patch Changes
Fix custom markdown tokenizer helper lexing to use Marked's active lexer so ordered list parsing no longer breaks inline tokenization in following paragraphs.
@tiptap/extension-drag-handle
Patch Changes
Updated
findElementNextToCoordsto fall back toview.posAtCoordswhenelementsFromPointreturns no matching block, resolving the position to the top-level block node.
@tiptap/extension-emoji
Patch Changes
Update emoji dataset to include latest Unicode emojis.
3.20.6
27 Mar 2026Fix drag preview cleanup so cloned drag images are also removed when dragging ends without a valid drop.
3.20.5
24 Mar 2026Add support for skipping trailing node insertion on transactions by setting the
skipTrailingNodemeta flag.
3.20.4
17 Mar 2026Only updates a dependency:@tiptap/core 3.20.4
3.20.3
16 Mar 2026Forward BubbleMenu and FloatingMenu HTML props to the actual menu element so attributes like
className,style,data-*, and event handlers bind to the positioned menu container.Generate a stable per-instance menu plugin key automatically when
pluginKeyis omitted, so multiple BubbleMenu or FloatingMenu components can be mounted without colliding.Forward BubbleMenu and FloatingMenu HTML props to the actual menu element so attributes like
className,style,data-*, and event handlers bind to the positioned menu container.
@tiptap/react
Patch Changes
Forward BubbleMenu and FloatingMenu HTML props to the actual menu element so attributes like
className,style,data-*, and event handlers bind to the positioned menu container.Generate a stable per-instance menu plugin key automatically when
pluginKeyis omitted, so multiple BubbleMenu or FloatingMenu components can be mounted without colliding.
@tiptap/vue-2
Patch Changes
Forward BubbleMenu and FloatingMenu HTML props to the actual menu element so attributes like
className,style,data-*, and event handlers bind to the positioned menu container.Generate a stable per-instance menu plugin key automatically when
pluginKeyis omitted, so multiple BubbleMenu or FloatingMenu components can be mounted without colliding.
@tiptap/core
Patch Changes
Fixed
isNodeEmpty()so multi-line text with non-whitespace content is no longer treated as empty whenignoreWhitespaceis enabled.Fixed overlapping bold and italic markdown serialization and round-tripping.
@tiptap/extension-unique-id
Patch Changes
Fixed a bug where empty paragraphs accumulated in the document on every page reload when using the UniqueID extension with the Collaboration extension and an externally created Yjs provider.
@tiptap/extension-youtube
Patch Changes
Export missing
getEmbedUrlFromYoutubeUrlandisValidYoutubeUrlembed URL utility functions
@tiptap/vue-3
Patch Changes
Generate a stable per-instance menu plugin key automatically when
pluginKeyis omitted, so multiple BubbleMenu or FloatingMenu components can be mounted without colliding.
@tiptap/extension-placeholder
Patch Changes
Skip placeholder decorations on non-textblock nodes when
includeChildrenis enabled to prevent duplicate placeholders on wrapper nodes like lists.
@tiptap/extension-bold
Patch Changes
Fixed overlapping bold and italic markdown serialization and round-tripping.
@tiptap/extension-italic
Patch Changes
Fixed overlapping bold and italic markdown serialization and round-tripping.
@tiptap/markdown
Patch Changes
Fixed overlapping bold and italic markdown serialization and round-tripping.
3.20.2
15 Mar 2026Improved markdown empty-paragraph roundtripping across top-level and nested block content. Empty paragraphs now serialize with natural blank-line spacing for the first paragraph in a run and
markers for subsequent empty paragraphs at the same level, while parsing preserves those empty paragraphs when converting markdown back to JSON.
3.20.1
6 Mar 2026Fix tilde-fenced code blocks (
~~~) being silently dropped when parsing markdownFix Drag event listener is removed when a plugin is registered after the DragHandle plugin.
Add support for
types: 'all'inUniqueIDto target every node type exceptdocandtext.
@tiptap/extension-code-block
Patch Changes
Fix tilde-fenced code blocks (
~~~) being silently dropped when parsing markdown
@tiptap/extension-drag-handle
Patch Changes
Fix Drag event listener is removed when a plugin is registered after the DragHandle plugin.
@tiptap/extension-unique-id
Patch Changes
Add support for
types: 'all'inUniqueIDto target every node type exceptdocandtext.
@tiptap/core
Patch Changes
Fix inline
styleparsing inmergeAttributesfor values containing:or;(e.g.url(https://...)orurl(data:...;charset=...,)) and skip incomplete declarations
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.