notion-md

Convert Markdown to Notion blocks with full format support.

Features

• Rich Text: Bold, italic, strikethrough, inline code, underline, color
• Headings: H1, H2, H3 with proper styling
• Lists: Bulleted, numbered, toggle lists
• Blocks: Quotes, callouts, dividers, code blocks
• Advanced: Tables, nested content, links
• Parent Page: Configurable parent page ID

Setup

1. Get Notion API Key

1. Go to https://www.notion.so/my-integrations
2. Create new integration
3. Copy the API key (starts with ntn_)

2. Configure API Key

# 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_key

3. Get Parent Page ID

The parent page where new pages will be created:

notion-md list-pages

Or set default:

export NOTION_PARENT_PAGE_ID="parent_page_id"

Usage

Create Page from File

notion-md create --file article.md --title "My Article" --emoji 📝

Create from stdin

echo "# Hello World" | notion-md create "Page Title"

Options

List Pages

notion-md list-pages

Append to Page

echo "## New Section" | notion-md append --page-id "abc123..."

Notion Format Mapping

Examples

Rich Content

# My Article

**This is bold** and *this is italic*.

> Important quote here

## Code Example

```python
def hello():
    print("Hello World")

• Item 1
• Item 2

### Create with Options

```bash
notion-md create \
  --file blog-post.md \
  --title "My Blog Post" \
  --emoji ✍️ \
  --parent-id "page_id_here"

Environment Variables

API Version

Notion API: 2022-06-28