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

  本技能来自小葱技能站7w4.net。

• 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

这个 Skill 文档质量不错，说明清晰易懂，示例实用，格式支持对照表一目了然。它能帮助用户将 Markdown 内容转换为 Notion 页面，支持多种格式如标题、列表、代码块等。配置说明详细，环境变量设置也很清楚。美中不足的是目前只有说明文档，缺少实际可运行的程序文件。