echo724/notion2md

Notion Markdown Exporter with Python Cli

About Notion2Md

• Notion Markdown Exporter using official notion api by notion-sdk-py

Notion2Medium

• Check out Notion2Medium that publishes a Medium post from Notion using Notion2Md.

API Key(Token)

• Before getting started, create an integration and find the token. → Learn more about authorization.

• Then save your api key(token) as your os environment variable

• From version 2.9.0, you can use --token or -t option to set your token key.

$ export NOTION_TOKEN="{your integration token key}"

Install

$ pip install notion2md

Usage: Shell Command

• Notion2md requires either id or url of the Notion page/block.

• download option will download files/images in the path directory.

• unzipped option makes Notion2Md export unzipped output of Notion block.

notion2md --download -n post -p ~/MyBlog/content/posts -u https://notion.so/...

• This command will generate "post.zip" in your '~/MyBlog/content/posts' directory.

Usage: Python

from notion2md.exporter.block import MarkdownExporter, StringExporter

# MarkdownExporter will make markdown file on your output path
MarkdownExporter(block_id='...',output_path='...',download=True).export()

# StringExporter will return output as String type
md = StringExporter(block_id='...',output_path='...').export()

To-do

• Download file object(image and files)
• Table blocks
• Synced Block
• Page Exporter
• Child page
• Column List and Column Blocks

Contribution

Please read Contribution Guide

Donation

If you think Notion2Md is helpful to you, you can support me here:

License

MIT