Skip to content

v4.0.0-alpha.2

Pre-release
Pre-release
Compare
Choose a tag to compare
@souvikinator souvikinator released this 08 Mar 00:52
· 4 commits to v4.0.0-alpha since this release
9ccaec2

notion-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.