name: notion-md description: Convert Markdown to Notion blocks with full format support. Handles bold, italic, strikethrough, inline code, headings, lists, tables, callouts, and more. homepage: https://developers.notion.com/reference/block metadata: openclaw: emoji: "📝" requires: env: ["NOTION_API_KEY"] primaryEnv: "NOTION_API_KEY"

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

  訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

• 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

這個 Skill 文件質量不錯，說明清晰易懂，示例實用，格式支援對照表一目瞭然。它能幫助使用者將 Markdown 內容轉換為 Notion 頁面，支援多種格式如標題、列表、程式碼塊等。配置說明詳細，環境變數設定也很清楚。美中不足的是目前只有說明文件，缺少實際可執行的程式檔案。