@tiptap/extension-code-block
3.35.0 · 20 Nov 2026MIT34.9M / weekRepositoryHomepagenpmAtom feed
213 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
3.20.1
6 Mar 2026Fix tilde-fenced code blocks (
~~~) being silently dropped when parsing markdown
3.20.0
18 Feb 2026Add
transformPastedHTMLextension API that allows extensions to transform pasted HTML content before it's parsed into the editor, enabling cleanup of styles, removal of dangerous content, and modification of pasted HTML through a chainable transform system.Fix checking if mark is active and toggling off marks when part of the selection does not allow the mark (e.g. a code block)
Global attributes now support shorthand string values for
types: use'*'to apply to all nodes and marks,'nodes'for all nodes (excluding text), or'marks'for all marks.
@tiptap/core
Minor Changes
Add
transformPastedHTMLextension API that allows extensions to transform pasted HTML content before it's parsed into the editor, enabling cleanup of styles, removal of dangerous content, and modification of pasted HTML through a chainable transform system.
Patch Changes
Fix checking if mark is active and toggling off marks when part of the selection does not allow the mark (e.g. a code block)
Global attributes now support shorthand string values for
types: use'*'to apply to all nodes and marks,'nodes'for all nodes (excluding text), or'marks'for all marks.
@tiptap/extension-drag-handle
Patch Changes
Fix drag handle not appearing for atom/leaf nodes like images in both nested and non-nested modes
Add table structure rules to prevent drag handle on table rows, cells, and headers, and fix ghost table rows when dragging tables
Fix drag position resolving outside the document when dragging an empty text node at the end of the document
@tiptap/markdown
Patch Changes
Fixed getMarkdown() returning
instead of empty string when editor is empty
@tiptap/extension-bubble-menu
Patch Changes
Fix
BubbleMenu/FloatingMenuto usepluginKeyas the transaction meta key so that multiple instances can be updated independently without affecting each other
@tiptap/extension-floating-menu
Patch Changes
Fix
BubbleMenu/FloatingMenuto usepluginKeyas the transaction meta key so that multiple instances can be updated independently without affecting each other
@tiptap/react
Minor Changes
Moved BubbleMenu and FloatingMenu to separate
@tiptap/react/menusentrypoint to keep floating-ui optionalSimplified Tiptap component API with guaranteed non-null editor instance from useTiptap hook
Patch Changes
Fix
BubbleMenu/FloatingMenuto usepluginKeyas the transaction meta key so that multiple instances can be updated independently without affecting each other
@tiptap/extension-code-block-lowlight
Patch Changes
Fixed a runtime error when initializing
CodeBlockLowlightby switching theCodeBlockimport to a named export. This preventsextend is not a functionerrors caused by ESM/CJS interop issues.
@tiptap/extension-invisible-characters
Patch Changes
Added missing storage typings
3.19.0
3 Feb 2026Add
titleattribute to Link extension. The title can now be set viasetLinkandtoggleLinkcommands and is rendered as an HTML title attribute.Add title attribute support for markdown rendering. Links with titles are now serialized to markdown format
[text](url "title").Moved BubbleMenu and FloatingMenu to separate
@tiptap/react/menusentrypoint to keep floating-ui optional
@tiptap/extension-link
Patch Changes
Add
titleattribute to Link extension. The title can now be set viasetLinkandtoggleLinkcommands and is rendered as an HTML title attribute.Add title attribute support for markdown rendering. Links with titles are now serialized to markdown format
[text](url "title").
@tiptap/react
Minor Changes
Moved BubbleMenu and FloatingMenu to separate
@tiptap/react/menusentrypoint to keep floating-ui optionalSimplified Tiptap component API with guaranteed non-null editor instance from useTiptap hook
3.18.0
28 Jan 2026Fix BubbleMenu and FloatingMenu props not updating after initialization
Fix BubbleMenu and FloatingMenu props not updating after initialization
Introduce a new, optional React integration that provides a declarative
<Tiptap />component for setting up editors in React apps.Summary
Why this change
Migration and usage
Example
import { Tiptap, useEditor } from '@tiptap/react' function MyEditor() { const editor = useEditor({ extensions: [StarterKit], content: '<h1>Hello from Tiptap</h1>' }) return ( <Tiptap instance={editor}> <Tiptap.Content /> <Tiptap.BubbleMenu>My Bubble Menu</Tiptap.BubbleMenu> <Tiptap.FloatingMenu>My Floating Menu</Tiptap.FloatingMenu> <MenuBar /> {/* MenuBar can use the new `useTiptap` hook to read the editor instance from context */} </Tiptap> ) }Deprecation plan
@tiptap/extension-bubble-menu
Patch Changes
Fix BubbleMenu and FloatingMenu props not updating after initialization
@tiptap/extension-floating-menu
Patch Changes
Fix BubbleMenu and FloatingMenu props not updating after initialization
@tiptap/react
Minor Changes
Introduce a new, optional React integration that provides a declarative
<Tiptap />component for setting up editors in React apps.Summary
Add a new, ergonomic way to initialize and use Tiptap editors in React via
<Tiptap />components. This is an additive change and does not remove or change existing APIs.
Why this change
Improves ergonomics for React users by offering a component-first API that pairs well with React patterns (hooks, JSX composition and props-driven configuration).
Migration and usage
The old programmatic setup remains supported for this major version — nothing breaks. We encourage consumers to try the new
<Tiptap />component and migrate when convenient.
Example
import { Tiptap, useEditor } from '@tiptap/react' function MyEditor() { const editor = useEditor({ extensions: [StarterKit], content: '<h1>Hello from Tiptap</h1>' }) return ( <Tiptap instance={editor}> <Tiptap.Content /> <Tiptap.BubbleMenu>My Bubble Menu</Tiptap.BubbleMenu> <Tiptap.FloatingMenu>My Floating Menu</Tiptap.FloatingMenu> <MenuBar /> {/* MenuBar can use the new `useTiptap` hook to read the editor instance from context */} </Tiptap> ) }Deprecation plan
The old imperative setup will remain fully backward-compatible for this major release. We plan to deprecate (and remove) the legacy setup in the next major version — a deprecation notice and migration guide will be published ahead of that change.
Patch Changes
Fix BubbleMenu and FloatingMenu props not updating after initialization
Fixed extension storage not updating in React and Vue node views
@tiptap/vue-3
Patch Changes
Fixed extension storage not updating in React and Vue node views
@tiptap/markdown
@tiptap/extensions
Patch Changes
Added a new
dataAttributeto the extension option to control which attribute name will be used for the placeholder label.
3.17.1
24 Jan 2026Fixed markdown serialization doubling newlines and parsing collapsing multiple blank lines
Fixed markdown serialization doubling newlines and parsing collapsing multiple blank lines
Fixed markdown HTML parsing when window object is unavailable in server-side environments
@tiptap/extension-paragraph
Patch Changes
Fixed markdown serialization doubling newlines and parsing collapsing multiple blank lines
@tiptap/markdown
Patch Changes
Fixed markdown serialization doubling newlines and parsing collapsing multiple blank lines
Fixed markdown HTML parsing when window object is unavailable in server-side environments
Fixed ordered list numbering when list has a non-default start value
@tiptap/vue-3
Patch Changes
Fixed IME input (Chinese, Japanese, Korean) in Vue 3 mark views by preventing DOM element destruction during composition events
@tiptap/extension-collaboration-caret
Patch Changes
Fixed CollaborationCaret crash with "Cannot read properties of undefined (reading 'doc')" error by updating to @tiptap/y-tiptap@3.0.2, which includes a guard against undefined state during editor initialization. This issue affected editors initialized with HTML content, particularly when using tables.
@tiptap/extension-collaboration
Patch Changes
Fixed CollaborationCaret crash with "Cannot read properties of undefined (reading 'doc')" error by updating to @tiptap/y-tiptap@3.0.2, which includes a guard against undefined state during editor initialization. This issue affected editors initialized with HTML content, particularly when using tables.
@tiptap/extension-drag-handle
Patch Changes
Fixed CollaborationCaret crash with "Cannot read properties of undefined (reading 'doc')" error by updating to @tiptap/y-tiptap@3.0.2, which includes a guard against undefined state during editor initialization. This issue affected editors initialized with HTML content, particularly when using tables.
@tiptap/html
Patch Changes
Fixed server-side HTML parsing crash when content contains link, script, or style tags with resource references.
Fixed server exports failing in Node.js test environments with jsdom/happy-dom
@tiptap/extension-bubble-menu
Patch Changes
Fixed bubble and floating menus to properly handle hide middleware data, hiding menus when reference element is scrolled out of view
@tiptap/extension-floating-menu
Patch Changes
Fixed bubble and floating menus to properly handle hide middleware data, hiding menus when reference element is scrolled out of view
@tiptap/core
Patch Changes
Fixed
$nodes()method to correctly return inline nodes (like text, mention, etc.) by fixing thechildrengetter inNodePosclassFixed ResizableNodeView contentDOM getter to return null instead of undefined for proper TypeScript compatibility
@tiptap/extension-list
Patch Changes
Fixed ordered list numbering when list has a non-default start value
3.17.0
23 Jan 2026Added a safeguard to avoid
TypeError: Cannot read properties of null (reading 'domFromPos')being thrown when the editor was being destroyedAdded nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
Fixed Firefox bug where the text caret becomes invisible after drag and drop.
@tiptap/extension-bubble-menu
Patch Changes
Added a safeguard to avoid
TypeError: Cannot read properties of null (reading 'domFromPos')being thrown when the editor was being destroyed
@tiptap/extension-drag-handle
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
Patch Changes
Fixed Firefox bug where the text caret becomes invisible after drag and drop.
@tiptap/core
Patch Changes
Added
isFirefoxutility to core
@tiptap/extension-drag-handle-react
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
@tiptap/extension-drag-handle-vue-2
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
@tiptap/extension-drag-handle-vue-3
Minor Changes
Added nested drag handle support, allowing drag handles to appear for nested content like list items and blockquotes with configurable edge detection and custom rules.
3.16.0
20 Jan 2026Add a native audio extension with demos and tests.
Fix incorrect Markdown output when underline is mixed with bold or italic and their ranges do not fully overlap.
Fix overlapping underline/bold/italic serialization and add tests
@tiptap/extension-audio
Minor Changes
Add a native audio extension with demos and tests.
@tiptap/markdown
Patch Changes
Fix incorrect Markdown output when underline is mixed with bold or italic and their ranges do not fully overlap.
Fix overlapping underline/bold/italic serialization and add tests
@tiptap/extension-link
Patch Changes
Fixed an issue where clicking on non-link elements (like images) required multiple clicks to select them. The link click handler now properly returns early when the clicked element is not a link, allowing other node handlers to process the click event.
@tiptap/extension-floating-menu
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/react
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/vue-2
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/vue-3
Minor Changes
Add updateEvent support for FloatingMenu to allow programmatic position updates via
setMeta('floatingMenu', 'updatePosition')
@tiptap/extension-unique-id
Patch Changes
Improved
findDuplicateshelper performance from O(n²) to O(n) by using Set-based lookups instead of Array.indexOf
3.15.3
7 Jan 2026Fix Safari scrolling to top when using editor.chain().focus() commands
3.15.2
7 Jan 2026Prevent auto-linking of bare hostnames (e.g.,
localhost) and IP addresses without a protocol prefixFix lost HTML attributes in TaskItem node view updates
Fix Vue prop validation warning for
appendToprop in BubbleMenu and FloatingMenu
@tiptap/extension-link
Patch Changes
Prevent auto-linking of bare hostnames (e.g.,
localhost) and IP addresses without a protocol prefix
@tiptap/extension-list
Patch Changes
Fix lost HTML attributes in TaskItem node view updates
@tiptap/vue-2
Patch Changes
Fix Vue prop validation warning for
appendToprop in BubbleMenu and FloatingMenu
@tiptap/vue-3
Patch Changes
Fix Vue prop validation warning for
appendToprop in BubbleMenu and FloatingMenu
@tiptap/extension-youtube
Patch Changes
Fix YouTube Shorts embed URLs using incorrect query parameter separator
@tiptap/react
Patch Changes
Fix race conditions in ReactRenderer causing destroyed renderers to be re-added in Strict Mode
3.15.1
6 Jan 2026Add a new
shouldShowcallback to theSuggestionutility. This allows developers to filter when suggestions are displayed, which is especially useful for collaborative environments to prevent suggestions from popping open for remote users.
3.15.0
5 Jan 2026Add a new
dispatchTransactionhook to extensions, allowing developers to intercept, modify, or block transactions before they are applied to the editor state.Fix unique ID assignment when handling empty nodes by checking next node's attribute state in the transaction document before modifying it, preventing incorrect ID assignments.
3.14.0
19 Dec 2025Add new Twitch extension for embedding Twitch videos, clips, and live channels in the editor. Supports customizable parameters like autoplay, muted, and start time, with attribute-level overrides for per-embed configuration.
Documentation: tiptap.dev/docs/editor/extensions/nodes/twitch
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/extension-twitch
Minor Changes
Add new Twitch extension for embedding Twitch videos, clips, and live channels in the editor. Supports customizable parameters like autoplay, muted, and start time, with attribute-level overrides for per-embed configuration.
Documentation: tiptap.dev/docs/editor/extensions/nodes/twitch
@tiptap/react
Patch Changes
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/vue-2
Patch Changes
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/vue-3
Patch Changes
Append all children of editors parent node to element
Fixes a regression introduced by #6972, that resulted in elements that got appended to the editors parent node staying detached. E.g. the drag handle plugin is affected by this regression.
@tiptap/extension-drag-handle
Patch Changes
Fix
findElementNextToCoordsto resolve the parent whennodeAt(pos)is null
(e.g., inside an atom node that allows inline content)
3.13.0
5 Dec 2025Added
data-draggingattribute to drag handle elements to track drag state.Added
data-draggingattribute to drag handle elements to track drag state.Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle-react
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle-vue-2
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-drag-handle-vue-3
Patch Changes
Added
data-draggingattribute to drag handle elements to track drag state.
@tiptap/extension-link
Patch Changes
Ensure
enableClickSelectionworks regardless of theopenOnClickoption by always registering the link click handler plugin.
@tiptap/extension-table-of-contents
Patch Changes
Skip the table of contents update logic during IME input method composition to avoid interference with input.
@tiptap/markdown
Patch Changes
Fixed trailing and leading whitespace handling in markdown serialization for inline marks
@tiptap/extension-mention
Patch Changes
Add 'mentionSuggestionChar' to allowedAttributes for Markdown serialization in multi-mention setups. The attribute is only serialized when it differs from the default '@' character, keeping markdown output clean for single-mention users.
@tiptap/core
Minor Changes
Added an optional
createCustomHandlecallback toResizableNodeView, allowing developers to fully customize resize handles. When provided, it replaces the default handle creation and bypasses the built-inpositionHandlelogic, giving complete control over markup, styling, and positioning while preserving backward compatibility.Removed predefined inline styles from the
wrapperelement to better support dynamic alignment. This eliminates the need for!importantoverrides in user styles.Added an editor
updateevent listener to dynamically attach or remove resize handles based on the editor’s editable state. The implementation tracks the previous editable state to avoid unnecessary re-renders.
Patch Changes
Add 'mentionSuggestionChar' to allowedAttributes for Markdown serialization in multi-mention setups. The attribute is only serialized when it differs from the default '@' character, keeping markdown output clean for single-mention users.
@tiptap/extension-image
Minor Changes
Added an optional
createCustomHandlecallback toResizableNodeView, allowing developers to fully customize resize handles. When provided, it replaces the default handle creation and bypasses the built-inpositionHandlelogic, giving complete control over markup, styling, and positioning while preserving backward compatibility.Removed predefined inline styles from the
wrapperelement to better support dynamic alignment. This eliminates the need for!importantoverrides in user styles.Added an editor
updateevent listener to dynamically attach or remove resize handles based on the editor’s editable state. The implementation tracks the previous editable state to avoid unnecessary re-renders.
3.12.1
3 Dec 2025Fixed a bug that mutated the ProseMirror document during server-side rendering, which could cause "Invalid content for node doc" errors.
3.12.0
2 Dec 2025Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Avoid mutating
this.optionsin theupdateUsercommand.this.optionscan be a getter and is not writable; the command now updates the provider awareness directly so user updates are applied correctly.
@tiptap/extension-collaboration
Minor Changes
Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Introduce
MappablePositionclass in core withposition,fromJSON, andtoJSONmethodsAdd
editor.utilsproperty withgetUpdatedPosition(position, transaction)andcreateMappablePosition()methodsCreate
CollaborationMappablePositionsubclass that extendsMappablePositionwith Y.js relative position support
@tiptap/core
Minor Changes
Implement position mapping using the
MappablePositionclass. This enables position mapping in collaborative editing scenarios.Introduce
MappablePositionclass in core withposition,fromJSON, andtoJSONmethodsAdd
editor.utilsproperty withgetUpdatedPosition(position, transaction)andcreateMappablePosition()methodsCreate
CollaborationMappablePositionsubclass that extendsMappablePositionwith Y.js relative position support
@tiptap/extension-collaboration-caret
Patch Changes
Avoid mutating
this.optionsin theupdateUsercommand.this.optionscan be a getter and is not writable; the command now updates the provider awareness directly so user updates are applied correctly.
@tiptap/react
Minor Changes
Replaced unmaintained
fast-deep-equaldependency with maintainedfast-equals
Patch Changes
Fix a bug where React node views could receive invalid positions from
this.getPos()when ProseMirror and React render cycles got out of sync, which could cause errors during updates.
3.11.1
27 Nov 2025Improve TypeScript generics for Node.extend
The Node.extend method's TypeScript signature was updated so that ExtendedConfig can extend NodeConfig and MarkConfig,
improving type inference when extending Node and Mark classes with additional config properties.This is a type-only change — there are no runtime behavior changes.
Fixed a bug where the TrailingNode extension would not use the node option to assume the default node type
3.11.0
19 Nov 2025Add native text direction support for RTL and bidirectional content. The editor now includes a
textDirectionoption that can be set to'ltr','rtl', or'auto'to control the direction of all content globally. Additionally, newsetTextDirectionandunsetTextDirectioncommands allow for granular control of text direction on specific nodes. This enables proper rendering of right-to-left languages like Arabic and Hebrew, as well as bidirectional text mixing multiple languages.
3.10.8
18 Nov 2025Fixed a bug that caused extra characters to be inserted after a parsed, nestable content block by accounting for leading newlines
Add documentation comments to Tiptap JSON types
Allow
undefinedas a value for thedefaultattribute key
@tiptap/core
Patch Changes
Fixed a bug that caused extra characters to be inserted after a parsed, nestable content block by accounting for leading newlines
Add documentation comments to Tiptap JSON types
Allow
undefinedas a value for thedefaultattribute keyFix
updateAttributesandresetAttributescommands to return accurate results when used with.can(). Previously, these commands would always returntrueeven when they couldn't perform the operation. Now they correctly returnfalsewhen no matching nodes or marks are found in the selection.
@tiptap/extension-text-align
Patch Changes
Fix
setTextAlignandunsetTextAligncommands to work correctly with.can()checks. Changed logic from.every()to.some()to returntruewhen at least one configured node type matches, rather than requiring all types to match.
@tiptap/static-renderer
Patch Changes
Fix static HTML renderer incorrectly generating self-closing tags for HTML elements that require proper closing tags (iframe, script, style, etc.).
@tiptap/markdown
Patch Changes
Fixed CommonJS compatibility by downgrading
markeddependency from v16 to v15.
3.10.7
12 Nov 2025Fix BubbleMenu plugin registration not triggering due to missing element reference during component initialization.
3.10.6
12 Nov 2025Fix BubbleMenu and FloatingMenu component runtime errors in Vue 2.
3.10.5
10 Nov 2025Fixed collaborative editing errors with certain emoji combinations (like 🔴🟢, 😎🐈, 🟣🔵) by updating
@tiptap/y-tiptapto stable v3.0.0.Fixed collaborative editing errors with certain emoji combinations (like 🔴🟢, 😎🐈, 🟣🔵) by updating
@tiptap/y-tiptapto stable v3.0.0.Fixed collaborative editing errors with certain emoji combinations (like 🔴🟢, 😎🐈, 🟣🔵) by updating
@tiptap/y-tiptapto stable v3.0.0.
Releases
@tiptap/extension-collaboration
Patch Changes
Fixed collaborative editing errors with certain emoji combinations (like 🔴🟢, 😎🐈, 🟣🔵) by updating
@tiptap/y-tiptapto stable v3.0.0.
@tiptap/extension-collaboration-caret
Patch Changes
Fixed collaborative editing errors with certain emoji combinations (like 🔴🟢, 😎🐈, 🟣🔵) by updating
@tiptap/y-tiptapto stable v3.0.0.
@tiptap/extension-drag-handle
Patch Changes
Fixed collaborative editing errors with certain emoji combinations (like 🔴🟢, 😎🐈, 🟣🔵) by updating
@tiptap/y-tiptapto stable v3.0.0.
@tiptap/core
Patch Changes
Fixed ProseMirror schema generation to properly respect
isRequiredattribute configuration. Previously, attributes marked withisRequired: truewere incorrectly treated as optional because adefaultproperty was always included in the schema specification. ProseMirror determines attribute requirements by the absence of thedefaultproperty, so now thedefaultis only included when the attribute is not required and a default value is explicitly defined.
@tiptap/extension-unique-id
Patch Changes
Fixed infinite transaction loop that caused browser tabs to freeze when using UniqueID and TrailingNode extensions together.
@tiptap/extensions
Patch Changes
Fixed infinite transaction loop that caused browser tabs to freeze when using UniqueID and TrailingNode extensions together.
3.10.4
8 Nov 2025Fix autofocus behavior to prevent unwanted scrolling when disabled
Fixed nested blockquote markdown serialization to properly handle multi-level nesting
3.10.3
7 Nov 2025Fix markdown serialization to prevent marks from continuing after hard breaks. Previously, marks like bold would incorrectly persist across hard breaks in the markdown output.
Fixed a bug where marks were resolved in incorrect orders, breaking markdown rendering for nested marks.
Fix parsing of mixed bullet lists and task lists. Previously, Marked.js would group consecutive bullet list items and task list items into a single list token, causing incorrect parsing. Now the parser detects mixed lists and splits them into separate bulletList and taskList nodes.
3.10.2
5 Nov 2025Fix parsing of mixed inline HTML within Markdown content so that inline HTML fragments are parsed correctly.
Allow setting custom table widths by respecting user-provided
styleattributes instead of always overriding them with calculated widths.
3.10.1
30 Oct 2025Use correct
ResizableNodeViewclass name
3.10.0
30 Oct 2025Add a new ResizableNodeview NodeView to core that wraps elements (images, videos, iframes) with configurable resize handles. It provides live onResize/onCommit callbacks, min/max constraints, aspect-ratio support, and styling hooks (class names + data attributes) to improve UX when resizing media inside the editor.
The addNodeView function can now return
nullto dynamically disable rendering of a node viewWhile this should not directly cause any issues, it's noteworthy as it still could affect some behavior in some edge cases.
Added a new
resizeoption that allows images to be resized. The option adds resize handlers to images allowing users to manually resize images via drag and drop or touch
3.9.1
29 Oct 2025Add a
renderWrapperoption to the Table extension so consumers can customize whether the table wrapper for the resizable node view should be rendered in non-editable mode as well.
3.9.0
28 Oct 2025Fix attribute forwarding for BubbleMenu and FloatingMenu Vue 3 components to allow setting z-index and other HTML attributes
Ensure that markdown hard breaks (two spaces followed by a newline) are parsed so they render as line breaks (
<br>) in the editor when usingcontentType: 'markdown'.Fixes #7107
Add
updateDocumentoption to disable document updates caused by the Unique ID extension.
Releases
@tiptap/vue-3
Patch Changes
Fix attribute forwarding for BubbleMenu and FloatingMenu Vue 3 components to allow setting z-index and other HTML attributes
@tiptap/extension-hard-break
Patch Changes
Ensure that markdown hard breaks (two spaces followed by a newline) are parsed so they render as line breaks (
<br>) in the editor when usingcontentType: 'markdown'.Fixes #7107
@tiptap/extension-unique-id
Minor Changes
Add
updateDocumentoption to disable document updates caused by the Unique ID extension.
@tiptap/core
Patch Changes
Only remove injected CSS on unmount if no other editors are in the document (fixes #6836)
@tiptap/extension-drag-handle
Patch Changes
Replace DOM traversal with browser's native elementsFromPoint for better performance.
Use elementsFromPoint instead of querySelectorAll
Add clampToContent helper for coordinate boundary validation
Add findClosestTopLevelBlock helper for efficient block lookup
Future-proof for root-level mousemove listeners
@tiptap/react
Patch Changes
Prevent Bubble Menu plugin from re-loading every time the BubbleMenu component re-renders. Reverts a regression introduced in v3.6.3, in PR #7028.
3.7.2
16 Oct 2025- Security
Fix CVE-2025-62410 by updating happy-dom to ^20.0.2
3.7.1
15 Oct 2025- Removed
Remove invalid server configuration from package.json
Editors will not throw an error anymore when
contentis an empty string andcontentTypeismarkdown
3.7.0
14 Oct 2025All commands and their corresponding TypeScript types are now exported from
@tiptap/coreso they can be imported and referenced directly by consumers. This makes it easier to build typed helpers, extensions, and tests that depend on the command signatures.Why:
import { commands } from '@tiptap/core'Notes:
Add comprehensive bidirectional markdown support to Tiptap through a new
@tiptap/markdownpackage and Markdown utilities in@tiptap/core.New Package:
@tiptap/markdown- A new official extension that provides full Markdown parsing and serialization capabilities using MarkedJS as the underlying Markdown parser.Core Features:
Extension API
editor.getMarkdown(): Serialize current editor content to Markdown string
Releases
@tiptap/core
Minor Changes
All commands and their corresponding TypeScript types are now exported from
@tiptap/coreso they can be imported and referenced directly by consumers. This makes it easier to build typed helpers, extensions, and tests that depend on the command signatures.Why:
Previously some command option types were only available as internal types or scattered across files, which made it awkward for downstream users to import and reuse them.
import { commands } from '@tiptap/core'Notes:
This is a non-breaking, additive change. It improves ergonomics for TypeScript consumers.
If you rely on previously private/internal types, prefer the exported types from
@tiptap/coregoing forward.
Add comprehensive bidirectional markdown support to Tiptap through a new
@tiptap/markdownpackage and Markdown utilities in@tiptap/core.New Package:
@tiptap/markdown- A new official extension that provides full Markdown parsing and serialization capabilities using MarkedJS as the underlying Markdown parser.Core Features:
Extension API
MarkdownExtension: Main extension that adds Markdown support to your editorMarkdownManager: Core engine for parsing and serializing MarkdownParse Markdown strings to Tiptap JSON:
editor.markdown.parse(markdown)Serialize Tiptap JSON to Markdown:
editor.markdown.serialize(json)Access to underlying marked.js instance:
editor.markdown.instance
Editor Methods
editor.getMarkdown(): Serialize current editor content to Markdown stringeditor.markdown: Access to MarkdownManager instance for advanced operations
Editor Options:
contentType: Control the type of content that is inserted into the editor. Can bejson,htmlormarkdown- defaults tojsonand will automatically detect invalid content types (like JSON when it is actually Markdown).new Editor({ content: '# Hello World', contentType: 'markdown' })
Command Options: All content commands now support an
contentTypeoption:setContent(markdown, { contentType: 'markdown' }): Replace editor content with markdowninsertContent(markdown, { contentType: 'markdown' }): Insert markdown at cursor positioninsertContentAt(position, markdown, { contentType: 'markdown' }): Insert Markdown at specific position
For more, check the documentation.
Patch Changes
The extension manager now provides a new property
baseExtensionsthat contains an unflattened array of extensions
@tiptap/markdown
Minor Changes
Add comprehensive bidirectional markdown support to Tiptap through a new
@tiptap/markdownpackage and Markdown utilities in@tiptap/core.New Package:
@tiptap/markdown- A new official extension that provides full Markdown parsing and serialization capabilities using MarkedJS as the underlying Markdown parser.Core Features:
Extension API
MarkdownExtension: Main extension that adds Markdown support to your editorMarkdownManager: Core engine for parsing and serializing MarkdownParse Markdown strings to Tiptap JSON:
editor.markdown.parse(markdown)Serialize Tiptap JSON to Markdown:
editor.markdown.serialize(json)Access to underlying marked.js instance:
editor.markdown.instance
Editor Methods
editor.getMarkdown(): Serialize current editor content to Markdown stringeditor.markdown: Access to MarkdownManager instance for advanced operations
Editor Options:
contentType: Control the type of content that is inserted into the editor. Can bejson,htmlormarkdown- defaults tojsonand will automatically detect invalid content types (like JSON when it is actually Markdown).new Editor({ content: '# Hello World', contentType: 'markdown' })
Command Options: All content commands now support an
contentTypeoption:setContent(markdown, { contentType: 'markdown' }): Replace editor content with markdowninsertContent(markdown, { contentType: 'markdown' }): Insert markdown at cursor positioninsertContentAt(position, markdown, { contentType: 'markdown' }): Insert Markdown at specific position
For more, check the documentation.
@tiptap/extension-link
Patch Changes
Paste Handlers and onPaste plugin now respect shouldAutoLink/validate options
@tiptap/extensions
Patch Changes
Make the
TrailingNodeextension'snodeoption optional and derive the
default node type from the editor schema when available.Previously the extension used a hard-coded
'paragraph'default and thenodeoption was required in the TypeScript definitions. This change:makes
nodeoptional in the options type,prefers the editor schema's top node default type when resolving the
trailing node, andfalls back to the configured option or
'paragraph'as a last resort.
This fixes cases where projects use a different top-level default node and
prevents the extension from inserting an incorrect trailing node type.
3.6.7
14 Oct 2025- Security
Fix CVE-2025-61927 by bumping happy-dom to 20.0.0
Bumps the transitive/dev dependency happy-dom from ^18.0.1 → ^20.0.0 in @tiptap/html to address CVE-2025-61927. This is a dependency/security-only change and does not modify any public APIs.
Why:
3.6.6
9 Oct 2025Fixed a problem where the position of a menu is not updated on creation when shouldShow is true
Fixed a problem where the position of a menu is not updated on creation when shouldShow is true
Fixed a bug that caused conditionally rendered bubble menus not to be attached to the DOM correctly
3.6.5
3 Oct 2025Added nextNodeType option to horizontal-rule extension, allowing users to specify which node type should be inserted after a horizontal rule
Editors can now emit
transactionandupdateevents before being mounted.
This means smoother state handling and instant feedback from editors, even when they're not in the DOM.
3.6.4
3 Oct 2025Clean up happy-dom window instance fixing a memory leak caused by unclosed happy-dom windows
3.6.3
2 Oct 2025Configuration options for the CodeBlock extension now support
nullandundefinedvalues.
This makes custom setups more flexible and avoids unnecessary type errors when omitting optional overrides.
All existing default values and fallback logic remain in place - no breaking changes for existing code.
3.6.2
29 Sep 2025Fix a bug where the bubble menu could throw an error if the editor was destroyed
while the plugin was cleaning up.
3.6.1
25 Sep 2025Hotfix: Fix a crash in the React package that could occur during mounting/unmounting when the editor wasn't fully initialized. This prevents a runtime error and improves stability.
3.6.0
25 Sep 2025- Removed
Remove recently added
updateBubbleMenuPositionmethod because it would not work in the React and Vue versions of the BubbleMenu, only in the vanilla extension. And that would confuse developers.Write the
transactionHandlermethod as an arrow function because arrow functions have nothis, so thethisremains the instance of theBubbleMenuViewclass. Improve typing and docs for
EditorOptions.elementto reflect all supported mounting modes and align behavior across adapters.Parse cell
colwidthfrom nearest<colgroup>when missing on the cellWhen importing HTML, table column widths are often declared on a surrounding
<colgroup>rather than on each<td>. Previously,tableCellonly read thecolwidthattribute from the cell itself and would lose width information in that case. The implementation now falls back to reading the corresponding<col>'swidthfrom the table's<colgroup>using the cell's index.This is a non-breaking bugfix that preserves layout information when HTML uses
<colgroup>. Consider adding a small demo or unit test to assert colwidth is preserved for cells when only the<colgroup>contains width attributes.
Releases
@tiptap/core
Patch Changes
Improve typing and docs for
EditorOptions.elementto reflect all supported mounting modes and align behavior across adapters.elementnow accepts:Element: the editor is appended inside the given element.{ mount: HTMLElement }: the editor is mounted directly tomount(no extra wrapper).(editorEl: HTMLElement) => void: a function that receives the editor element so you can place it anywhere in the DOM.null: no automatic mounting.
@tiptap/extension-table
Patch Changes
Parse cell
colwidthfrom nearest<colgroup>when missing on the cellWhen importing HTML, table column widths are often declared on a surrounding
<colgroup>rather than on each<td>. Previously,tableCellonly read thecolwidthattribute from the cell itself and would lose width information in that case. The implementation now falls back to reading the corresponding<col>'swidthfrom the table's<colgroup>using the cell's index.This is a non-breaking bugfix that preserves layout information when HTML uses
<colgroup>. Consider adding a small demo or unit test to assert colwidth is preserved for cells when only the<colgroup>contains width attributes.Fixes table wrapper replacement and lost selections when
resizable: true.TableView.ignoreMutation now ignores attribute/childList/characterData mutations that occur inside the table wrapper but outside the editable
contentDOM, preventing wrapper re-creation during resize interactions so selections (e.g.mergeCells()) are preserved.No API or breaking changes.
@tiptap/extension-bubble-menu
Patch Changes
- Removed
Remove recently added
updateBubbleMenuPositionmethod because it would not work in the React and Vue versions of the BubbleMenu, only in the vanilla extension. And that would confuse developers.Write the
transactionHandlermethod as an arrow function because arrow functions have nothis, so thethisremains the instance of theBubbleMenuViewclass.
@tiptap/extension-unique-id
Minor Changes
Create a utility to add unique IDs to a document in the server
The utility is called
generateUniqueIdsand is exported from the@tiptap/extension-unique-idpackage.It has the same functionality as the
UniqueIDextension, but without the need to create anEditorinstance. This lets you add unique IDs to the document in the server.It takes the following parameters:
doc: The Tiptap JSON document to add unique IDs to.extensions: The extensions to use. Must include theUniqueIDextension.
It returns the updated Tiptap JSON document, with the unique IDs added to the nodes.
@tiptap/vue-3
Minor Changes
Pass
attrsthrough Vue 3 menus
3.5.3
25 Sep 2025Merge nested span styles only for immediate child spans and guard style values.
This change fixes a bug that could cause exponential work when parsing deeply
nested<span>elements - in extreme cases that could make the tab unresponsive
or crash the renderer. It is a bugfix / performance improvement with no public API
changes.
3.5.2
24 Sep 2025Tiptap will now correctly insert a React MarkViews' content into the correct element within
MarkViewContentcomponent
3.5.1
23 Sep 2025Add
appendTosupport toFloatingMenuand pass it through in React/Vue 2/Vue 3 for bothBubbleMenuandFloatingMenuto allow fixing clipping/z-index issues.Add
appendTosupport toFloatingMenuand pass it through in React/Vue 2/Vue 3 for bothBubbleMenuandFloatingMenuto allow fixing clipping/z-index issues.Add
appendTosupport toFloatingMenuand pass it through in React/Vue 2/Vue 3 for bothBubbleMenuandFloatingMenuto allow fixing clipping/z-index issues.
@tiptap/extension-floating-menu
Patch Changes
Add
appendTosupport toFloatingMenuand pass it through in React/Vue 2/Vue 3 for bothBubbleMenuandFloatingMenuto allow fixing clipping/z-index issues.
@tiptap/react
Patch Changes
Add
appendTosupport toFloatingMenuand pass it through in React/Vue 2/Vue 3 for bothBubbleMenuandFloatingMenuto allow fixing clipping/z-index issues.
@tiptap/vue-2
Patch Changes
Add
appendTosupport toFloatingMenuand pass it through in React/Vue 2/Vue 3 for bothBubbleMenuandFloatingMenuto allow fixing clipping/z-index issues.
@tiptap/vue-3
Patch Changes
Add
appendTosupport toFloatingMenuand pass it through in React/Vue 2/Vue 3 for bothBubbleMenuandFloatingMenuto allow fixing clipping/z-index issues.
3.5.0
23 Sep 2025Add
updateBubbleMenuPositioncommand to update position of bubble menu. This command lets developers programmatically update the position of the bubble menu in response to certain events (for example, when the bubble menu is resized).Add
getReferencedVirtualElementoption to the drag handle extension to customize the position of the drag handle.Fixed
findElementNextToCoordsreturning incorrect nodes when the position is at a node boundary. The function now correctly identifies leaf nodes (like images, horizontal rules) by checking$pos.nodeAfterbefore falling back to the parent node lookup.
Releases
@tiptap/extension-bubble-menu@3.5.0
Minor Changes
Add
updateBubbleMenuPositioncommand to update position of bubble menu. This command lets developers programmatically update the position of the bubble menu in response to certain events (for example, when the bubble menu is resized).
@tiptap/extension-drag-handle@3.5.0
Minor Changes
Add
getReferencedVirtualElementoption to the drag handle extension to customize the position of the drag handle.
Patch Changes
Fixed
findElementNextToCoordsreturning incorrect nodes when the position is at a node boundary. The function now correctly identifies leaf nodes (like images, horizontal rules) by checking$pos.nodeAfterbefore falling back to the parent node lookup.
@tiptap/vue-2@3.5.0
Patch Changes
Fix Vue2 menus visibility bug.
3.4.6
22 Sep 2025Added support for the
undoableoption in InputRules (matching ProseMirror’s implementation).This brings Tiptap’s InputRules behavior in line with ProseMirror and gives developers finer control over undo functionality.
3.4.5
22 Sep 2025Fix an issue where injected CSS was not mounted correctly when the editor instance was mounted. The fix ensures CSS injected by the editor is attached to the document when the editor mounts, preventing missing styles in some mount/unmount scenarios.
Use a named import for Suggestion from
@tiptap/suggestionto avoid bundler ESM/CJS interop
wrapping (__toESM) that caused Jest/CJS consumers to receive a module object instead of the
callable plugin factory.This is a non-breaking internal fix. It keeps runtime module shape stable for CommonJS (Jest)
and prevents the TypeError thrown when the extension attempted to call a non-function.
Releases
@tiptap/core@3.4.5
Patch Changes
Fix an issue where injected CSS was not mounted correctly when the editor instance was mounted. The fix ensures CSS injected by the editor is attached to the document when the editor mounts, preventing missing styles in some mount/unmount scenarios.
@tiptap/extension-code-block-lowlight@3.4.5
@tiptap/extension-emoji@3.4.5
@tiptap/extension-mention@3.4.5
Patch Changes
Use a named import for Suggestion from
@tiptap/suggestionto avoid bundler ESM/CJS interop
wrapping (__toESM) that caused Jest/CJS consumers to receive a module object instead of the
callable plugin factory.This is a non-breaking internal fix. It keeps runtime module shape stable for CommonJS (Jest)
and prevents the TypeError thrown when the extension attempted to call a non-function.
3.4.4
17 Sep 2025Fix bug in
insertContentAtcommand where extra content would get deleted when the selection was at the beginning of the document and a node was inserted
3.4.3
15 Sep 2025When the editor view is created, it now will also include
nodeViewsandmarkViewsproperties instead of setting them afterward. This avoids serialization of the editor state to HTML which will be replaced by node views anyway.Add custom positioning support to the BubbleMenu.
This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example
getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.Add custom positioning support to the BubbleMenu.
This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example
getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.
Releases
@tiptap/core@3.4.3
Patch Changes
When the editor view is created, it now will also include
nodeViewsandmarkViewsproperties instead of setting them afterward. This avoids serialization of the editor state to HTML which will be replaced by node views anyway.
@tiptap/extension-bubble-menu@3.4.3
Patch Changes
Add custom positioning support to the BubbleMenu.
This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example
getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.
@tiptap/react@3.4.3
Patch Changes
Add custom positioning support to the BubbleMenu.
This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example
getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.
@tiptap/vue-2@3.4.3
Patch Changes
Add custom positioning support to the BubbleMenu.
This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example
getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.
@tiptap/vue-3@3.4.3
Patch Changes
Add custom positioning support to the BubbleMenu.
This change adds an opt-in API that allows consumers to fully control how the BubbleMenu is positioned. Instead of relying solely on the internal placement logic, you can now provide a function (for example
getPosition) that receives the relevant context (editor instance and menu DOM element) and returns the desired coordinates or positioning style.
3.4.2
9 Sep 2025Listen to a custom scroll target when positioning the BubbleMenu and
ensure the scroll listener is cleaned up on destroy.The BubbleMenu now accepts an optional
scrollTargetoption which will be
used instead ofwindowwhen listening for scroll events that affect the
menu positioning. The plugin also removes the scroll listener during
cleanup.No user-facing API changes other than the new optional
scrollTargetsetting.
3.4.1
4 Sep 2025Prefer the raw inline
styleattribute when parsingcolorandbackground-colorso the original format (hex, rgba/hsla, etc.) is
preserved instead of falling back to the computedelement.style.*
value (which often resolves torgb(...)).This fixes mismatches where consumers (for example, demo toolbars and
color pickers) expected the original hex values when initializing the
editor from HTML.MIGRATION NOTES
@types/react version mismatch
Previously,
clientRectwas only obtained throughdecorationNode. IfdecorationNodecould not be obtained,clientRectwas set tonull, which caused the suggestion not to render in some IME scenarios (notably Chinese IME).This change adds a fallback method to compute
clientRectfrom the editor's cursor position whendecorationNodeis not available. It generates a DOMRect based on the cursor coordinates so the suggestion can render even when the decoration node is missing.
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.