md2notion 0.1.2

Utilities for importing Markdown files to Notion.so

Notion.so Markdown Importer

An importer for Markdown files to Notion.so using notion-py

It provides these features over Notion.so's Markdown importer:

• Picking a Notion.so page to upload to (instead of them all uploading to the root)
• Code fences keep their original language (or as close as we can match it)
• Code fences are formatted properly
• Inline HTML is preserved
• Markdown frontmatter is preserved
• Local image references will be uploaded from relative URLs
• Image alts are loaded as captions instead of as TextBlocks
• Among other improvements...

Limitations

• Currently does not support tables/CollectionViewBlocks

Usage with Python 3.6+

• pip install md2notion

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

• OR In your Python file:

from notion.client import NotionClient
from md2notion.upload import upload

# Follow the instructions at https://github.com/jamalex/notion-py#quickstart to setup Notion.py
client = NotionClient(token_v2="<token_v2>")
page = client.get_block("https://www.notion.so/myorg/Test-c0d20a71c0944985ae96e661ccc99821")

with open("TestMarkdown.md", "r", encoding="utf-8") as mdFile:
    newPage = page.children.add_new(PageBlock, title="TestMarkdown Upload")
    upload(mdFile, newPage) #Appends the converted contents of TestMarkdown.md to newPage

If you dislike the way this package implements a specific Markdown to Notion.so conversion, you can subclass NotionPyRenderer (a BaseRenderer for mistletoe) and pass it to upload(..., notionPyRendererCls=NotionPyRenderer).

If you need to post process your converted Markdown before uploading the blocks to Notion.so, you can convert your file before uploading. Take a look at upload.py for more.

from md2notion.upload import convert, uploadBlock

rendered = convert(mdFile)

# Process the rendered array of `notion-py` block descriptors here
# (just dicts with some properties to pass to `notion-py`)

# Upload all the blocks
for blockDescriptor in rendered:
    uploadBlock(blockDescriptor, page, mdFile.name)

Example, Hexo Importer

Here's an example that imports a Hexo blog

import os.path
import glob
from pathlib import Path
from notion.block import PageBlock
from notion.client import NotionClient
from md2notion.upload import upload

client = NotionClient(token_v2="<token_v2>")
page = client.get_block("https://www.notion.so/myorg/Test-c0d20a71c0944985ae96e661ccc99821")

for fp in glob.glob("../source/_posts/*.md", recursive=True):
    with open(fp, "r", encoding="utf-8") as mdFile:
        pageName = os.path.basename(fp)[:40]
        newPage = page.children.add_new(PageBlock, title=pageName)
        print(f"Uploading {fp} to Notion.so at page {pageName}")
        #Get the image relative to the markdown file in the flavor that Hexo
        #stores its images (in a folder with the same name as the md file)
        def convertImagePath(imagePath, mdFilePath):
            return Path(mdFilePath).parent / Path(mdFilePath).stem / Path(imagePath)
        upload(mdFile, newPage, imagePathFunc=convertImagePath)

Contributing

See CONTRIBUTING.md