Markdown to Notion uploader with full-featured support powered by Mistune.

Upload rich, formatted Markdown files—including equations, code, tables, and attachments—directly to Notion with ease.

• ✅ Full Markdown Support via Mistune
• 📤 Upload to Notion using official API
• 📎 File & Image Attachment Support
• 🔗 Skips invalid links like anchors
• 📐 LaTeX Math Block Rendering
• 🧩 Plugin-based Parsing (supports strikethrough, footnotes, task lists, etc.)
• 📄 Table-to-Block Conversion
• 🧠 Smart Title Conflict Handling (timestamp, counter, ask, skip)
• 🛠️ Debug Mode for Development

pip install notionit

Then run:

notionit upload path/to/file.md --token YOUR_NOTION_TOKEN --parent-page-id YOUR_PAGE_ID

You'll see an animated progress bar showing upload percentage and remaining time.

Or use the convenience function in Python:

from notionit import quick_upload

quick_upload(
    file_path="example.md",
    token="secret_abc123",
    parent_page_id="notion_page_id",
)

Default enabled plugins:

• strikethrough
• mark
• insert
• subscript
• superscript
• footnotes
• table
• task_lists
• def_list
• abbr
• ruby
• math (via notionit.math_plugin.notion_math for single-line $$ and list support)

Customize them via --plugins or programmatically.

Optionally configure via environment variables:

Run notionit --help for full options:

notionit upload example.md \
  --page-title "My Notes" \
  --duplicate-strategy timestamp \
  --debug

During uploads, the CLI reports progress with a spinner and estimated remaining time.

• Publish lecture notes with math equations
• Upload tech blogs with code snippets
• Back up documentation in Notion
• Convert Markdown meeting notes into Notion pages

MIT