notion-mdConvert Markdown to Notion blocks with full format support. Handles bold, italic, strikethrough, inline code, headings, lists, tables, callouts, and more.
Install via ClawdBot CLI:
clawdbot install maweis1981/notion-mdConvert Markdown to Notion blocks with full format support.
ntn_)# Option A: Environment variable
export NOTION_API_KEY="ntn_your_key"
# Option B: Config file
mkdir -p ~/.config/notion
echo "ntn_your_key" > ~/.config/notion/api_keyThe parent page where new pages will be created:
notion-md list-pagesOr set default:
export NOTION_PARENT_PAGE_ID="parent_page_id"notion-md create --file article.md --title "My Article" --emoji 📝echo "# Hello World" | notion-md create "Page Title"| Option | Description |
|--------|-------------|
| --file, -f | Input Markdown file |
| --title, -t | Page title (required) |
| --emoji, -e | Page icon (default: 📄) |
| --parent-id, -p | Parent page ID |
| --dry-run | Preview without creating |
notion-md list-pagesecho "## New Section" | notion-md append --page-id "abc123..."| Markdown | Notion Block |
|----------|--------------|
| # Title | heading_1 |
| ## Title | heading_2 |
| ### Title | heading_3 |
| bold | bold annotation |
| italic | italic annotation |
| ~~text~~ | strikethrough |
| ` code ` | code annotation |
| --- | divider |
| - item | bulleted_list_item |
| 1. item | numbered_list_item |
| > quote | quote |
| ```text``` | code block |
| ::: callout | callout |
| \| table \| | table (basic) |
# My Article
**This is bold** and *this is italic*.
> Important quote here
## Code Exampledef hello():
print("Hello World")
- Item 1
- Item 2notion-md create \
--file blog-post.md \
--title "My Blog Post" \
--emoji ✍️ \
--parent-id "page_id_here"| Variable | Description |
|----------|-------------|
| NOTION_API_KEY | Notion API key |
| NOTION_PARENT_PAGE_ID | Default parent page ID |
Notion API: 2022-06-28
Generated Feb 24, 2026
Marketing teams can use this skill to convert blog post drafts written in Markdown into Notion pages for collaborative editing and approval workflows. It streamlines content production by allowing writers to work in familiar Markdown editors before publishing to Notion for team review and scheduling.
Software development teams can automate the conversion of Markdown-based documentation, such as README files or API guides, into structured Notion pages. This ensures technical docs are easily accessible and updatable in a centralized Notion workspace, improving knowledge sharing across engineers.
Researchers and students can export notes from Markdown tools into Notion to organize study materials, literature reviews, and project outlines. It supports complex formatting like tables and code blocks, making it ideal for compiling research data and collaborative academic projects.
Project managers can convert Markdown task lists and meeting notes into Notion pages to integrate with existing project boards. This enables seamless tracking of deliverables and milestones, enhancing team coordination and progress monitoring in agile environments.
E-commerce businesses can use this skill to batch-convert product descriptions from Markdown files into Notion pages for inventory management. It helps maintain consistent formatting across product listings and facilitates quick updates for seasonal campaigns or new launches.
Offer this skill as part of a paid subscription service for teams needing advanced Markdown-to-Notion conversion with premium features like bulk processing, custom templates, and priority support. Revenue is generated through monthly or annual plans tailored to business sizes.
Provide a free basic version for individual users with limited conversions, and charge for enterprise features such as API access, team collaboration tools, and enhanced security. This model attracts a broad user base and upsells to larger organizations.
Sell this skill as an add-on in marketplaces for productivity tools, targeting users of platforms like Slack or Zapier who need automated Notion integrations. Revenue comes from one-time purchases or commission-based sales through partner channels.
💬 Integration Tip
Ensure the NOTION_API_KEY is securely stored in environment variables to avoid exposure. Test with a dry-run option first to preview conversions before making live changes to Notion pages.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.