Skip to main content

A renderer and uploader for Markdown files to notion

Project description

twitter twitter

Markdown to Notion-py

A renderer and uploader for Markdown files to using notion-py

Why use this package?

As of writing, Notion's Markdown importer has some problems:

  • Code fences don't seem to retain their original language or format properly
  • Inline HTML is removed, including iframes
  • Markdown frontmatter is removed
  • Local image references show up as blank images
  • Image alts are loaded as TextBlocks instead of captions
  • Among others...

This package aims to make bulk import much easier by solving the problems above. If you dislike the way this package implements a specific Markdown to Notion conversion or you need extra functionality (like uploading your images to Cloud hosting), you can always subclass NotionPyRenderer (a BaseRenderer for mistletoe) and change it or hook its behavior.


  • Currently does not support tables/CollectionViewBlocks

Usage with Python 3.6+

  • pip install md2notion

  • From the command link you can run python -m md2notion.convert [token_v2] [page-url] [...markdown_path_globs]

  • OR In your Python file:

from notion.client import NotionClient
from md2notion.convert import convert

# Follow the instructions at to setup
client = NotionClient(token_v2="<token_v2>")
page = client.get_block("")

with open("", "r") as f:
    convert(f, page)



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 md2notion, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size md2notion-0.0.4-py3-none-any.whl (6.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size md2notion-0.0.4.tar.gz (5.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page