Skip to main content

Export notion page to markdown.

Project description

Notion Markdown Exporter

PyPI version

  • This is Notion Markdown Exporter using notion-py

  • notion2md will export your notion.so page to markdown formatted file.

Updates v1.2.0

  • Now Supports Exporting the inline table block

    • Even the block that has its own page in the table will be exported as subpage
  • You can choose wheather you will export notion page as a blog post or not

    • Blog post format includes frontmatter and Date in Post's name.

Features

  • [New] Token_v2 will be saved after using the exporter, and don't have to enter it next time

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

Requirements

  • token_v2: check the way to get Token_v2 in Notion-py Quickstart

  • Caution Do not share your Token_v2 with others. Others can access your notion page if the token is shared.

  • url: the link that you will export

Installation

pip install notion2md

Usage in Terminal

In your Bash/Zsh terminal,

$python3 -m notion2md
#Token_v2: <your token_v2 on notion.so>
#Notion Page Url: <your notion page to export>
# Choose you will export the notion page as blog post: [y/n]

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

Usage in Python

from notion2md import *

export_cli()
# Token_v2: <your token_v2 on notion.so>
# Notion Page Url: <your notion page to export>
# Choose you will export the notion page as blog post: [y/n]

Output Structure.

The structure of the output looks like this path.

notion_output/
├── notion_token.json
└── <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.

Todo

  • convert other block types to md. 

Change Log

Contribution

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.

License

MIT

Project details


Download files

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

Files for notion2md, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size notion2md-1.2.1-py3-none-any.whl (7.3 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page