v4.0.0-alpha.2
Pre-releasenotion-to-md v4.0.0-alpha.2
This is the first alpha release of notion-to-md v4.0.0, a complete redesign that transforms the library from a simple markdown converter into a powerful and extensible content transformation system.
What does it mean?
Extensibility
- Create custom formats beyond just Markdown
- Define exactly how each Notion element should appear
- Connect Notion to any publishing system or workflow
From Notion to Anywhere
- Turn Notion pages into blog posts, React components, documentation sites and a lot more. The possibilities are endless.
- Use Notion as your editor while publishing anywhere
Media Made Easy
- Store media where you need them: local folders, S3, your CDN or anywhere
- Full control over the media management
Cross-References
- Links between Notion pages work properly in your published content
- Automatically transform internal Notion links to your site's URL structure
- Keep your content connected even outside Notion
With v4, Notion becomes your universal content source that integrates with anything and everything.
Status
This is an early alpha release meant for testing and feedback. The API may change before the stable release. We welcome your input on the new architecture and any issues you encounter.
What's New
- Builder Pattern API: Intuitive configuration with method chaining
- Modular Architecture: Core functionality is now divided into specialized components
- Plugin System: Easily extend with custom renderers to output any format (MD, MDX, HTML, JSX, etc.)
- Robust Media Handling: Multiple strategies for media content (direct URLs, download, upload to storage)
- Page References: Automatic handling of Notion page links for proper cross-references
- Improved Performance: Optimized block fetching with concurrency control
Documentation
For detailed documentation and examples, visit: https://notionconvert.com/notion-to-md/
Breaking Changes
This is a complete rewrite with a new API and architecture. Existing code using v3.x will need to be updated to the new patterns. Detailed migration guides will be provided in future releases.