highlight extension for tiptap
Tiptap is a headless wrapper around ProseMirror – a toolkit for building rich text WYSIWYG editors, which is already in use at many well-known companies such as New York Times, The Guardian or Atlassian.
Documentation can be found on the Tiptap website.
Tiptap is open sourced software licensed under the MIT license.
the addNodeView function can now return null to dynamically disable rendering of a node view
While this should not directly cause any issues, it's noteworthy as it still could affect some behavior in some edge cases.
ueberdosis
resize option that allows images to be resized. The option adds resize handlers to images allowing users to manually resize images via drag and drop or touchrenderWrapper option 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.Ensure that markdown hard breaks (two spaces followed by a newline) are parsed so they render as line breaks (<br>) in the editor when using contentType: 'markdown'.
Fixes #7107
updateDocument option to disable document updates caused by the Unique ID extension.Replace DOM traversal with browser's native elementsFromPoint for better performance.
updateDocument option to disable document updates caused by the Unique ID extension.content is an empty string and contentType is markdownAll commands and their corresponding TypeScript types are now exported from @tiptap/core so 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:
@tiptap/core going forward.Add comprehensive bidirectional markdown support to Tiptap through a new @tiptap/markdown package 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
Markdown Extension: Main extension that adds Markdown support to your editorMarkdownManager: Core engine for parsing and serializing Markdowneditor.markdown.parse(markdown)editor.markdown.serialize(json)editor.markdown.instanceeditor.getMarkdown(): Serialize current editor content to Markdown stringeditor.markdown: Access to MarkdownManager instance for advanced operationsEditor Options:
contentType: Control the type of content that is inserted into the editor. Can be json, html or markdown - defaults to json and 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 contentType option:
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 positionFor more, check the documentation.
baseExtensions that contains an unflattened array of extensionsAdd comprehensive bidirectional markdown support to Tiptap through a new @tiptap/markdown package 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
Markdown Extension: Main extension that adds Markdown support to your editorMarkdownManager: Core engine for parsing and serializing Markdowneditor.markdown.parse(markdown)editor.markdown.serialize(json)editor.markdown.instanceeditor.getMarkdown(): Serialize current editor content to Markdown stringeditor.markdown: Access to MarkdownManager instance for advanced operationsEditor Options:
contentType: Control the type of content that is inserted into the editor. Can be json, html or markdown - defaults to json and 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 contentType option:
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 positionFor more, check the documentation.
Make the TrailingNode extension's node option optional and derive the
default node type from the editor schema when available.
Previously the extension used a hard-coded 'paragraph' default and the
node option was required in the TypeScript definitions. This change:
node optional in the options type,'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.
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:
transaction and update events before being mounted.
This means smoother state handling and instant feedback from editors, even when they're not in the DOM.FloatingMenu plugin hook dependencies to match the BubbleMenu behavior.
The FloatingMenu will now respond to changes in appendTo, pluginKey, shouldShow, and options.appendTo prop passed to the React BubbleMenu component is now correctly forwarded to the underlying bubble menu plugin. This fix allows developers to customize where the BubbleMenu is attached in the DOM, helping resolve issues with positioning and portal setups in React apps.null and undefined values.
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.JSONContent.attrs definition to exactly mirror the structure returned by editor.getJSON(). This ensures strict type safety and consistency between the editor output and the expected type, eliminating errors caused by mismatched attribute signatures.appendTo option in the floating and bubble menu
extensions. The callback must return an element synchronously,
so menus can be appended to elements that are created dynamically.appendTo option in the floating and bubble menu
extensions. The callback must return an element synchronously,
so menus can be appended to elements that are created dynamically.Improve typing and docs for EditorOptions.element to reflect all supported mounting modes and align behavior across adapters.
element now accepts:Element: the editor is appended inside the given element.{ mount: HTMLElement }: the editor is mounted directly to mount (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.Parse cell colwidth from nearest <colgroup> when missing on the cell
When importing HTML, table column widths are often declared on a surrounding <colgroup> rather than on each <td>. Previously, tableCell only read the colwidth attribute from the cell itself and would lose width information in that case. The implementation now falls back to reading the corresponding <col>'s width from 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.
Remove recently added updateBubbleMenuPosition method 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 transactionHandler method as an arrow function because arrow functions have no this, so the this remains the instance of the BubbleMenuView class.
Create a utility to add unique IDs to a document in the server
The utility is called generateUniqueIds and is exported from the @tiptap/extension-unique-id package.
It has the same functionality as the UniqueID extension, but without the need to create an Editor instance. 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 the UniqueID extension.It returns the updated Tiptap JSON document, with the unique IDs added to the nodes.
attrs through Vue 3 menusMerge nested span styles only for immediate child spans and guard style values.
<span> elements.style attributes.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.
MarkViewContent componentappendTo support to FloatingMenu and pass it through in React/Vue 2/Vue 3 for both BubbleMenu and FloatingMenu to allow fixing clipping/z-index issues.appendTo support to FloatingMenu and pass it through in React/Vue 2/Vue 3 for both BubbleMenu and FloatingMenu to allow fixing clipping/z-index issues.appendTo support to FloatingMenu and pass it through in React/Vue 2/Vue 3 for both BubbleMenu and FloatingMenu to allow fixing clipping/z-index issues.appendTo support to FloatingMenu and pass it through in React/Vue 2/Vue 3 for both BubbleMenu and FloatingMenu to allow fixing clipping/z-index issues.Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
Note: Version bump only for package tiptap
i in defaultBlockAt by @andreavaccari in https://github.com/ueberdosis/tiptap/pull/1315Color extension to set the text color by @hanspagel in https://github.com/ueberdosis/tiptap/pull/1744this.value to value in the vue examples with v-model by @MiloLug in https://github.com/ueberdosis/tiptap/pull/1813ReactRenderer types by @rfgamaral in https://github.com/ueberdosis/tiptap/pull/2011editor dependency when registering BubbleMenuPlugin by @ValentaTomas in https://github.com/ueberdosis/tiptap/pull/2018defaultOptions with addOptions by @philippkuehn in https://github.com/ueberdosis/tiptap/pull/2088CollaborationCursor extension by @hanspagel in https://github.com/ueberdosis/tiptap/pull/2096enableInputRules and enablePasteRules by @aguingand in https://github.com/ueberdosis/tiptap/pull/2119setEditable to the Editor documentation by @floriankrueger in https://github.com/ueberdosis/tiptap/pull/2199as option and pass through to ReactRenderer by @jessicalc in https://github.com/ueberdosis/tiptap/pull/2213createView by @BrianHung in https://github.com/ueberdosis/tiptap/pull/2212type="context" tag by @duruer in https://github.com/ueberdosis/tiptap/pull/2240CharacterCount extension by @philippkuehn in https://github.com/ueberdosis/tiptap/pull/2256element.current from useEffect in BubbleMenu and FloatingMenu by @ValentaTomas in https://github.com/ueberdosis/tiptap/pull/2297Level for external use by @webri in https://github.com/ueberdosis/tiptap/pull/2354@tiptap/react and @tiptap/core as side effect free by @dcastil in https://github.com/ueberdosis/tiptap/pull/2361javascript: pseudo-protocol by @phenax in https://github.com/ueberdosis/tiptap/pull/2646onBeforeStart and onBeforeUpdate handlers to the render function by @rfgamaral in https://github.com/ueberdosis/tiptap/pull/2628getTextSerializersFromSchema helper, and fix typo in its name by @sjdemartini in https://github.com/ueberdosis/tiptap/pull/2750className option and pass through to ReactRenderer by @anton-liubushkin in https://github.com/ueberdosis/tiptap/pull/2794Avoid mutating a prop directly error message to reproduce by @HondryTravis in https://github.com/ueberdosis/tiptap/pull/2834@tiptap/extension-code-block-lowlight by @enriquecastl in https://github.com/ueberdosis/tiptap/pull/2625whiteSpace style for NodeViewWrapper & NodeViewContent by @EvitanRelta in https://github.com/ueberdosis/tiptap/pull/2884nodeInputRule by @ahhshm in https://github.com/ueberdosis/tiptap/pull/2954flushSync to microtask by @sampi in https://github.com/ueberdosis/tiptap/pull/3188editor.setEditable to omit updates by @ZaymonFC in https://github.com/ueberdosis/tiptap/pull/3301nodePasteRule find type to most generic PasteRuleFinder by @jiegillet in https://github.com/ueberdosis/tiptap/pull/3759createNodeFromContent and other missing helpers by @jacksleight in https://github.com/ueberdosis/tiptap/pull/3558documentClear plugin by @thecodrr in https://github.com/ueberdosis/tiptap/pull/3778