0.39.0 (2025-09-18)
🎉 Major API Overhaul & TipTap V3 Upgrade
This is a major release for BlockNote that brings significant improvements to our custom block APIs, enhanced HTML parsing capabilities, and an upgrade to TipTap V3. We've completely overhauled our internal default blocks to use the same custom block APIs that we expose externally, allowing us to "dogfood" our own APIs and ensure they have everything needed for robust custom block development.
✨ Key Features
🔧 Enhanced Custom Block APIs
Configurable Block Schemas
- Custom blocks can now take configuration options, allowing you to change your schema based on configuration
- Support for dynamic block configurations (e.g., code blocks with different syntax highlighting options, heading blocks with flexible heading levels)
Extended Custom Inline Content & Styles
- Custom inline content and styles now support parsing and exporting to HTML
- Greater flexibility between what you render in-editor vs. what gets exported to HTML
- New
toExternalHTMLandparsefunctions for both inline content and styles
BlockNote Extensions Integration
- BlockNote extensions can now define input rules and keyboard shortcuts
- Extensions can be added directly to custom block specs
- Support for ProseMirror plugins and TipTap extensions within custom blocks
Extensible Schemas
- BlockNote schemas are now fully extensible
- Add your own custom blocks, inline content, and styles to existing schemas
- Better integration between built-in and custom components
🚀 TipTap V3 Upgrade
- Upgraded to TipTap V3, enabling access to the latest features and improvements
- Better performance and stability
- Enhanced editor capabilities
📄 Improved HTML Parsing
- Significantly improved support for parsing content from HTML
- Better detection of styles and content when parsing arbitrary HTML
- More reliable conversion from external HTML sources
🔄 Breaking Changes
Due to the major API overhaul, some existing custom block implementations may need updates:
- Custom block configurations have been restructured
- New optional parameters added to block implementations
- Some internal APIs have been refactored for better consistency
🎯 What This Means for You
- Better Custom Block Development: You can now see exactly how we build our own blocks and use the same APIs
- More Flexible Rendering: Better control over how content appears in-editor vs. exported HTML
- Enhanced Extensibility: More ways to customize and extend BlockNote's functionality
- Improved Reliability: Better HTML parsing and more robust custom block APIs
This release represents a significant step forward in making BlockNote more flexible and powerful for custom implementations while maintaining the ease of use that makes it great for standard use cases.