v4.0.0-alpha.6

What's Changed

• V4 jsx renderer by @yashvikram30 in #154
• feat(page-ref): robust page reference handler module and page reference builder module by @souvikinator in #159
• Remove leading whitespace in toggle transformer by @Richie-Moon in #153

New Contributors

• @yashvikram30 made their first contribution in #154
• @Richie-Moon made their first contribution in #153

Detailed changes

Bug fixes

• Fixes #149 , #156

Improvements:

• Page reference handler & builder now refers to Notion page property of type url, rich_text/plain text and formula (return type string), previously it only supported URL type
• The Notion property that Page reference handler points/referres to should not contain a full valid URL instead of a slug
• Centralized all the common utilities, reduced redundancies and made the concerned modules and utils testable

Tests

• Added unit test for Notion utilities, rate limiter, page manifest manager, page reference builder.
• Added unit test for Page reference handler module

Full Changelog: v4.0.0-alpha.5...v4.0.0-alpha.6

v4.0.0-alpha.7

Fixes:

• #156 issue
• #140 (partially)

Improvements:

• Fix: page ref handler not updating blocks
• Since page ref handler is meant for internal linking, updating block with path makes more sense. Added useUrlPath boolean property in the config (true by default). Change to false for it to update with full URL.
• Fix: inline equations not rendering due to space issue
• Fix: equations with other annotations fail to render. We no longer apply any annotations to the equation.

Tests:

• test for the above cases

v3.1.9

What's Changed

• fix: handle undefined parent when quote has paragraph content by @mdnorman in #138

New Contributors

• @mdnorman made their first contribution in #138

Full Changelog: v3.1.8...v3.1.9

NOTE: This will likely be the final release for v3.x.x (unless urgent fixes are needed). We wanted to ensure all content-related updates are available for you before we proceed with v4 development

Due to architectural limitation and community requirements we are working on notion-to-md v4 with focus on:

• Expanding content format support beyond Markdown (MDX, JSX, HTML, LATEX....you name it!)
• Performance enhancements
• Enhanced support for static site generators and CMS workflow focused
• Greater customization for unique use cases

The latest v4 alpha release can be found here

Would appreciate your participation in the development, let us know if it'll handle your use case :)

v4.0.0-alpha.5

What's Changed

Notion Child Database Support #112

• Property Transformers: Custom renderers for database properties via createPropertyTransformer.
• Query Database: Query Notion databases similarly to the official SDK for filtered data rendering.
• Database Layout Control: Customizable database appearance with block transformers.
• Rich Property Types: Full support for property types like select, multi-select, people, and files.

Enhanced Frontmatter Configuration #132

• Frontmatter Transformation: Custom logic for property values before adding them to frontmatter using the transform option.

Direct Media Strategy with In-Memory Buffering #130

• In-Memory Media Processing: Process media (images, PDFs) in memory without disk saving. Ideas for serverless environment.
• Flexible Media Handling: Choose media types to buffer with size limits.
• Enhanced Control: Access media content as Node.js Buffers for transformations.
• Optimized Performance: Reduce disk I/O for media files.

Expanded Media Handling Scope #133

• Comprehensive Media Management: Apply media strategies consistently across all Notion content (blocks, database and page properties)
• Controlled Scope: Use enableFor in your media strategy to specify processing from block, database_property, and/or page elements.

Detailed changelog: https://notionconvert.com/docs/v4/changelog/v4-0-0-alpha-5/

Full Changelog: v4.0.0-alpha.4...v4.0.0-alpha.5

v3.1.8

What's Changed

• Skip children of table that are not table_row by @tjenkinson in #131

New Contributors

• @tjenkinson and @angusjf made their first contribution in #131 🔥

Full Changelog: v3.1.7...v3.1.8

NOTE: This will likely be the final release for v3.x.x (unless urgent fixes are needed). We wanted to ensure all content-related updates are available for you before we proceed with v4 development

Due to architectural limitation and community requirements we are working on notion-to-md v4 with focus on:

• Expanding content format support beyond Markdown (MDX, JSX, HTML, LATEX....you name it!)
• Performance enhancements
• Enhanced support for static site generators and CMS workflow focused
• Greater customization for unique use cases

The latest v4 alpha release can be found here

Would appreciate your participation in the development, let us know if it'll handle your use case :)

v4.0.0-alpha.4

What's changed

Package Improvements

• Migrated build system from tsc to tsup for improved bundling
• Reduced bundle size by approx 35.52% (compared to other alpha v4 release)
• Restructured package with barrel files for cleaner imports on the user end
• Added exports and typeVersion properties for better TypeScript support
• Fixed TypeScript configuration discrepancies

Plugin development

• Added manifest manager access in renderer context for plugin developers, making it easier to access media/documents related info
• The media handler now performs path transformation (if provided) even if the media Notion block hasn't changed.

Documentation

• Added new blog posts on:
  • "How to Convert Notion Properties to Frontmatter"
  • "How to Convert Notion Comments to Markdown Footnotes"
  • "How to handle embedded media/documents like pdf in Notion"
• Enabled comments on documentation pages
• Updated Hugo configuration for better docs site functionality

Join the discussion for v4

What's cooking? 🔥

🚀 We're building a playground to export Notion pages into any format! Check it out in progress at Exporto
Eventually it'll do a lot more ;) Here's a sneak peek of the first iteration:

v4.0.0-alpha.3

What's changed?

• Fixed model resolution and IntelliSense issues after the build.
• Moved @notionhq/client from dependency to peer dependency.

Full Changelog: v4.0.0-alpha.2...v4.0.0-alpha.3

Join the discussion for v4

What's cooking? 🔥

🚀 We're building a playground to export Notion pages into any format! Check it out in progress at Exporto
Eventually it'll do a lot more ;) Here's a sneak peek of the first iteration:

v4.0.0-alpha.2

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.

v3.1.7

What's Changed

• Fix: Inconsistent interpretation of tab spaces used for indentation

Full Changelog: v3.1.6...v3.1.7

NOTE: This will likely be the final release for v3.x.x (unless urgent fixes are needed). We wanted to ensure all content-related updates are available for you before we proceed with v4 development

Due to architectural limitation and community requirement we are working on notion-to-md v4 with focus on:

• Expanding content format support beyond Markdown (MDX, JSX, HTML, LATEX....you name it!)
• Performance enhancements
• Enhanced support for static site generators and CMS workflow focused
• Greater customization for unique use cases

Would appreciate your participation in the proposal, let us know if it'll handle your usecase :)

v3.1.6

What's Changed

• matching interface changes in notion package by @artable in #126

New Contributors

• @artable made their first contribution in #126

Full Changelog: v3.1.5...v3.1.6

NOTE: This will likely be the final release for v3.x.x (unless urgent fixes are needed). We wanted to ensure all content-related updates are available for you before we proceed with v4 development

Due to architectural limitation and community requirement we are working on notion-to-md v4 with focus on:

• Expanding content format support beyond Markdown (MDX, JSX, HTML, LATEX....you name it!)
• Performance enhancements
• Enhanced support for static site generators and CMS workflow focused
• Greater customization for unique use cases

Would appreciate your participation in the proposal, let us know if it'll handle your usecase :)