v0.28.0

0.28.0 (2025-04-07)

🚀 Features

• Add new trackPosition API which resolves (#1529)

❤️ Thank You

• Nick Perez

v0.27.2

0.27.2 (2025-04-05)

🩹 Fixes

• minor update for publishing (c2820fdac)

❤️ Thank You

• Nick the Sick

v0.27.0

0.27.0 (2025-04-04)

• Smaller bundle size: ~100 kB less, with more features
• Blockquote Block: You can now add quotes with this new block type
• Customizable Code Blocks: Control how code blocks do syntax highlighting, add more supported languages, smaller bundle size, theming
• Markdown pasting, and custom paste handlers: You can now paste markdown into the editor & it will be pasted as rich text! Support for custom paste handling behaviors with configurable callback

Breaking changes

Code block syntax highlighting removed

We no longer automatically include syntax highlighting for code blocks, this significantly reduces our bundle size and allows for more flexibility in terms of including the languages & themes your application may need. To see how to add syntax highlighting, read our guide for setting it up: https://www.blocknotejs.org/docs/advanced/code-blocks

Localizations are available from a new export

We no longer include locales as an export directly from @blocknote/core, the same locales are now available from @blocknote/core/locales, allowing you to import just the locales you need in your application. This significantly reduces the bundle size of blocknote, see more about localization in our example: https://www.blocknotejs.org/examples/basic/localization

Why?

To achieve a better bundle size, and reduce the number of dependencies of the package we were able to go from:

Before (v0.26.0):

dist/webpack-stats.json   14.11 kB │ gzip:  2.41 kB
dist/style.css            11.60 kB │ gzip:  2.82 kB
dist/comments.js          17.51 kB │ gzip:  3.54 kB │ map:    49.69 kB
dist/blocknote.js        422.01 kB │ gzip: 95.01 kB │ map: 1,116.10 kB
dist/webpack-stats.json   14.11 kB │ gzip:  2.41 kB
dist/style.css            11.60 kB │ gzip:  2.82 kB
dist/comments.cjs         11.83 kB │ gzip:  2.87 kB │ map:    47.56 kB
dist/blocknote.cjs       277.15 kB │ gzip: 73.99 kB │ map: 1,055.32 kB

After (v0.27.0):

dist/webpack-stats.json   14.59 kB │ gzip:  2.53 kB
dist/style.css            11.76 kB │ gzip:  2.86 kB
dist/en-B7ycW7c8.js        8.06 kB │ gzip:  2.00 kB │ map:  14.54 kB
dist/comments.js          17.51 kB │ gzip:  3.54 kB │ map:  49.77 kB
dist/locales.js          141.51 kB │ gzip: 28.23 kB │ map: 249.57 kB
dist/blocknote.js        280.46 kB │ gzip: 66.76 kB │ map: 874.62 kB
dist/webpack-stats.json   14.61 kB │ gzip:  2.52 kB
dist/style.css            11.76 kB │ gzip:  2.86 kB
dist/en-D4taoCs4.cjs       5.54 kB │ gzip:  1.84 kB │ map:  12.80 kB
dist/comments.cjs         11.83 kB │ gzip:  2.87 kB │ map:  47.59 kB
dist/locales.cjs          98.00 kB │ gzip: 25.89 kB │ map: 220.20 kB
dist/blocknote.cjs       179.33 kB │ gzip: 48.15 kB │ map: 844.04 kB

By splitting out the localizations and code block, the main bundle (blocknote.js) went from 422 kB to 280 kB!

🚀 Features

• split out localization files for optimized bundle (#1533)
• remove shiki dep, add new @blocknote/code-block package for slim shiki build (#1519)
• Blockquote Block (#1563)
• markdown pasting & custom paste handlers (#1490)

🩹 Fixes

• Backspace in empty block deletes previous block (#1505)
• Selection when clicking past end of inline content (#1553)
• better expose setting a draghandlemenu's items #1525 (#1526, #1525)
• Multi-block links (#1565)
• Hard break keyboard shortcut not working in custom blocks (#1554)
• Overlapping marks in comments (#1564)
• some more sentry fixes (#1577)

❤️ Thank You

• Martinrsts @Martinrsts
• Matthew Lipski @matthewlipski
• Nick Perez

v0.26.0

Thanks to our sponsors!

💖 The threads sidebar has been sponsored by DINUM 🇫🇷 and ZenDiS 🇩🇪

Threads Sidebar

This release introduces the ThreadsSidebar component, which displays threads & comments in a separate section next to the editor. It's meant to be used as an alternative way of viewing and interacting with comments to the default UI, where threads float next to the content they're referring to. See the docs to find out how to use and customize the ThreadsSidebar!

Screen.Recording.2025-03-19.at.10.53.32-1.mp4

What's Changed

• fix: Drag & drop for blocks with iframes not working by @matthewlipski in #1531
• fix: table error in collaboration mode by @YousefED in #1536
• fix: resolve several sentry errors by @nperez0111 in #1524
• fix: improve markview setup by @YousefED in #1544
• docs: Added Agree sponsor by @matthewlipski in #1542
• chore: add unit test for table parsing by @YousefED in #1547
• fix: immediately add nodeviews to fix flushSync error by @YousefED in #1546
• feat: Threads sidebar by @matthewlipski in #1454

Full Changelog: v0.25.2...v0.26.0

v0.25.2

What's Changed

• fix: resolve unneeded error being thrown by @nperez0111 in #1503
• fix: check for undefined headerMatrix resolves #1506 by @nperez0111 in #1507
• fix: React custom blocks not valid drop targets by @matthewlipski in #1511
• fix: small issues related to comments by @YousefED in #1520
• fix: export react components #1509 by @nperez0111 in #1510

Full Changelog: v0.25.1...v0.25.2

v0.25.1

What's Changed

This is mostly a set of bug fixes around the 0.25.0 release

• docs: fix link to DefaultThreadStoreAuth source code by @BinaryMuse in #1489
• fix: peerDependenciesMeta typo by @YousefED in #1495
• fix: scope cursor caret CSS to be more specific by @nperez0111 in #1492
• fix: compatibility with new react-pdf by @YousefED in #1494
• fix: pull from the default export which is available in both ESM and CJS (#1468) by @nperez0111 in #1493
• fix: upgrade y-prosemirror and remove clientID hack by @YousefED in #1497
• fix: prefix the collaboration cursor classname by @nperez0111 in #1498
• fix: import emoji-mart dynamically like (#950) by @nperez0111 in #1491
• docs: add sentry to website for error detection by @nperez0111 in #1496

New Contributors

• @BinaryMuse made their first contribution in #1489

Full Changelog: v0.25.0...v0.25.1

v0.25.0

Thanks to our sponsors!

💖 Comments & ODT exports has been sponsored by DINUM 🇫🇷 and ZenDiS 🇩🇪
💖 Tables overhaul has been sponsored by Agree.com 💖

New Features

Today, is a big release, we have 3 huge features that we've been working on for months, and we are excited to hear your feedback on it!

Comments (Sponsored by DINUM 🇫🇷 and ZenDiS 🇩🇪)

Screen.Recording.2025-03-04.at.16.57.37.mp4

We've now added the ability to comment on BlockNote content, making your editor even more collaborative!

Here is a rundown of the specific functionality, available as part of this release:

• Adding comments to inline content (i.e. most text within the editor)
• Comment threading, allowing you to reply to comments and have discussions about a topic
• Resolving comments & threads once you've addressed the feedback
• Comment Reactions: respond to a comment with an emoji
• Editing & Deleting comments
• Pluggable backends, you can store your comment data anywhere you like, in a Y.js document or even your own REST API
• Separate user roles: editors or comment only permissions

Whew, That was a lot! To read more about comments, please take a look at our documentation.

Tables Update (Sponsored by Agree.com)

Screen.Recording.2025-03-04.at.16.54.49.mp4

Tables have gotten a huge overhaul, gaining some big new features along the way:

• Merging & splitting cells
• Cell background & text color
• Cell text alignment
• Table header rows & columns

We decided that since not everyone will want all of this new functionality, we have made these features completely opt-in and you can read more about them in the Advanced Tables guide in our documentation.

ODT Exports (Sponsored by DINUM 🇫🇷 and ZenDiS 🇩🇪)

We have added a new package @blocknote/xl-odt-exporter which can take a BlockNote document and output all of it's content as an ODT document export.

Breaking Changes

• UMD is no longer output by the packages, we now only export ESM & CJS built JS files. This should only affect those who have a build pipeline which uses AMD modules.

For the nerds

• docs: Ordered editor options alphabetically and updated docs by @matthewlipski in #1471
• feat: Comments by @YousefED in #1376
• feat(tables): overhaul table cells by @nperez0111 in #1429
• fix: Comments feedback & flaky test by @matthewlipski in #1481
• build: parallelize across browsers by @nperez0111 in #1472
• fix: externalize react-dom/client by @YousefED in #1483
• feature: odt exporter by @YousefED in #1331
• feat: support new table properties in PDF export by @nperez0111 in #1475
• build: separate new comments functionality into a separate path export by @nperez0111 in #1466
• fix: Removed @emoji-mart/react dependency by @matthewlipski in #1484
• fix: forward refs to the final component by @nperez0111 in #1485
• fix: Link toolbar update error by @matthewlipski in #1486

Full Changelog: v0.24.2...v0.25.0

v0.24.2

What's Changed

• fix: Blocks being deleted when dropped outside editor container by @matthewlipski in #1443
• fix: add detail to collab cursor error by @YousefED in #1449
• refactor: add renderEditor boolean to BlockNoteView by @YousefED in #1453
• fix: drag & drop issues by @matthewlipski in #1458
• fix: Formatting toolbar mouseup handler by @matthewlipski in #1460
• feat: File insertion QoL by @matthewlipski in #1459
• fix: Mantine CSS variables element by @matthewlipski in #1463
• test: attempt at getting test snapshots updated by @nperez0111 in #1469
• Add missing italian translation for page break block by @JuseGit in #1461
• feat: Norwegian localisation by @BaraKona in #1420

New Contributors

• @JuseGit made their first contribution in #1461
• @BaraKona made their first contribution in #1420

Full Changelog: v0.24.0...v0.24.2

v0.24.1

What's Changed

• fix: Blocks being deleted when dropped outside editor container by @matthewlipski in #1443
• fix: add detail to collab cursor error by @YousefED in #1449

Full Changelog: v0.24.0...v0.24.1

v0.24.0: mount improvements

This PR mostly lands some internal optimizations and refactorings. Most notably, the way the editor is mounted in React has been approved. This work prepares us for better comments integrations (such as LiveBlocks, stay tuned!)

Also, the "placeholder" feature has been improved. See PR: #1439

What's Changed

• refactor: new react mounting system by @YousefED in #1438
• fix: insertblocks when no type is provided by @YousefED in #1436
• fix: placeholder improvements by @YousefED in #1439
• refactor: support markviews by @YousefED in #1437
• refactor: reuse toolbar types and extract mantine context by @YousefED in #1440
• feat: add support for tiptap / liveblocks comments by @YousefED in #1442

Full Changelog: v0.23.6...v0.24.0