Skip to main content

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

  • Supports Inline Math Code in the text block, bulleted list, and numbered list.It will denoted as $$<math code>$$

  • Supports Call export_cli() with token_v2, url, and bmode

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

  • Downloads images and files in notion's page

  • Exports Nested Pages!

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

$python -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=<Token_v2>,url=<Notion.so Page's url>,bmode=<0 or 1>)

# Without any parameters will call this prompts
# 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.

notion2md_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

Metadata

Release files for notion2md 1.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for notion2md 1.2.3
File Interpreter ABI Platform
notion2md-1.2.3-py3-none-any.whl Python 3 none any Details

Release files / notion2md-1.2.3-py3-none-any.whl

Download URL notion2md-1.2.3-py3-none-any.whl
Size 7.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
188af13e01c6fb583935886dfd5a874f89b8a0e9fb545f553c6617bffc1cca38
BLAKE2b-256 checksum
How to use checksums
3c2b94d9f5e0239a1fbed72e14228e57077652a772af68bc0de9ffb8438d885a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.6.0 requests/2.24.0 setuptools/50.3.0.post20201006 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.9

Security for notion2md 1.2.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

1.2.3 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page