Skip to main content

Export notion page to markdown.

Project description

Notion Markdown Exporter

PyPI version

The Notion2md is updated to version 1.0.0. Please update the pacakge.

  • This is Notion Markdown Exporter using notion-py

  • notion2md will export your page to markdown formatted file.


  • Changed the structure of the exporter to support exporting sub pages and sub files.

  • Used Object named 'PageBlockExporter' to connect supporting functions and attributes.

  • Each Exporter has its client(NotionClient), page(notion.Block), and sub pages' exporter list ([PageBlockExporter])


  • Converts almost every block in the notion's page to Markdown texts

  • Downloads images and files in notion's page

  • Exports Nested Pages in the page!

  • Create Front Matters for supporting CMS (Title, Created Date, Tags)

Add "Created" and "Tags" properties in your page. Then exporter will put them in the md file's front matter.


pip install notion2md

Usage in Terminal

In your Bash/Zsh terminal,

$python3 -m notion2md
#Token_v2: <your token_v2 on>
#Notion Page Url: <your notion page to export>

This will make <date-page-title>.md file in your directory/Notion_Exporter_Output folder.

Usage in Python

from notion2md import *

# Token_v2: <your token_v2 on>
# Notion Page Url: <your notion page to export>

Output Structure.

The structure of the output looks like this path.

└── <main-page-title>/
    ├── <main-page-title>.md
    ├── download/
    │   └── ...
    ├── image/
    │   └── img_1.png
    │   └── ...
    └── subpage/
        └── ...
  • in subpage/, there will be image/, download/, and subpage/ folders if there are sub components in sub page.


  • convert other block types to md.


Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

notion2md-1.1.0-py3-none-any.whl (6.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page