Notion-to-md-py

What's changed?

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

**Full Changelog**: https://github.com/souvikinator/notion-to-md/compare/v4.0.0-alpha.2...v4.0.0-alpha.3

Join the [discussion for v4](https://github.com/souvikinator/notion-to-md/discussions/112)

> What's cooking? 🔥
> 🚀 We're building a playground to export Notion pages into any format! Check it out in progress at [notion-convert-playground](https://github.com/Notion-Convert/notion-convert-playground)
> Eventually it'll do a lot more ;) Here's a sneak peek of the first iteration:
>
> <img src="https://raw.githubusercontent.com/Notion-Convert/notion-convert-playground/main/public/nc-playground.png" />

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.

<details>
<summary><h2>What does it mean?</h2></summary>

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

</details>

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/](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.

What's Changed
* Fix: Inconsistent interpretation of tab spaces used for indentation

**Full Changelog**: https://github.com/souvikinator/notion-to-md/compare/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 :)
> <div>
> <a href="https://github.com/souvikinator/notion-to-md/discussions/112">
> <img src="https://i.ibb.co/Tmyf805/Group-167.png" />
> </a>
> </div>

What's Changed
* matching interface changes in notion package by artable in https://github.com/souvikinator/notion-to-md/pull/126

New Contributors
* artable made their first contribution in https://github.com/souvikinator/notion-to-md/pull/126

**Full Changelog**: https://github.com/souvikinator/notion-to-md/compare/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 :)
> <div>
> <a href="https://github.com/souvikinator/notion-to-md/discussions/112">
> <img src="https://i.ibb.co/Tmyf805/Group-167.png" />
> </a>
> </div>

What's Changed
* Fix Notion Code Block Parsing in Markdown Export by sll518 in https://github.com/souvikinator/notion-to-md/pull/125

New Contributors
* sll518 made their first contribution in https://github.com/souvikinator/notion-to-md/pull/125

**Full Changelog**: https://github.com/souvikinator/notion-to-md/compare/v3.1.4...v3.1.5

> **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 :)
> <div>
> <a href="https://github.com/souvikinator/notion-to-md/discussions/112">
> <img src="https://i.ibb.co/Tmyf805/Group-167.png" />
> </a>
> </div>

What's Changed
* Fix regex callout heading by Mikescops in https://github.com/souvikinator/notion-to-md/pull/120


**Full Changelog**: https://github.com/souvikinator/notion-to-md/compare/v3.1.3...v3.1.4

> **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 :)
> <div>
> <a href="https://github.com/souvikinator/notion-to-md/discussions/112">
> <img src="https://i.ibb.co/Tmyf805/Group-167.png" />
> </a>
> </div>