Imported from cdeistopened/skill-stack (public/skills/notion-export/SKILL.md). Install upstream with npx skills add cdeistopened/skill-stack --skill notion-export. Copyright stays with the author.

Notion Export

Name: notion-export
Author: cdeistopened

Converts local markdown files to Notion pages with full rich text formatting preserved.

Quick Start

# Create new page under a parent
python3 ~/.claude/scripts/notion_markdown.py draft.md --parent-id <page_id> --title "My Article"

# Update existing page (replaces content)
python3 ~/.claude/scripts/notion_markdown.py draft.md --update <page_id>

# Search for a parent page
python3 ~/.claude/scripts/notion_markdown.py draft.md --search "Guest Contributors"

When to Use

Staging article drafts for team review
Exporting documentation to Notion workspace
Syncing local markdown files to Notion
When Notion MCP server is disconnected

Supported Formatting

Markdown	Notion
`bold`	Bold text
`italic`	Italic text
`[text](url)`	Link
`code`	Inline code
`# H1`	Heading 1
`## H2`	Heading 2
`### H3`	Heading 3
`- bullet`	Bulleted list
`1. numbered`	Numbered list
`> quote`	Quote block
`code block`	Code block
`---`	Divider

Requirements

Python 3 with requests library
Notion API key in .mcp.json or NOTION_API_KEY environment variable

Finding Page IDs

Page IDs can be found:

In the Notion URL: notion.so/Page-Name-abc123def456 → abc123def456
Using --search "query" to find pages by name
From previous exports/creates

Examples

Stage an article draft

python3 ~/.claude/scripts/notion_markdown.py \
  "Studio/SEO Content/drafts/my-article.md" \
  --parent-id "3d9f18f9-03a9-4374-ae5c-a57e85427060" \
  --title "[DRAFT] My Article Title"

Update after edits

python3 ~/.claude/scripts/notion_markdown.py \
  "Studio/SEO Content/drafts/my-article.md" \
  --update "2fdafe52-ef59-81dc-b1ac-e79b40c2d40d"

Common Parent Pages

Purpose	Page ID
OpenEd Content Engine	`3d9f18f9-03a9-4374-ae5c-a57e85427060`

Troubleshooting

"No Notion API key found"

Check .mcp.json has notion.env.NOTION_API_KEY configured
Or set NOTION_API_KEY environment variable

Formatting not appearing

Check markdown syntax is correct (no spaces in ** bold **)
Links must be [text](url) format, not bare URLs

Page not updating

Verify page ID is correct (use --search to find)
Check API key has edit permissions for the page

{ "ocm": "1", "id": "cdeistopened-skill-stack-notion-export", "kind": "skill", "name": "notion-export", "description": "Export markdown files to Notion with proper rich text formatting. Use when staging articles, drafts, or documentation in Notion. Handles bold, italic, links, headers, bullets, numbered lists, and code blocks.", "publisher": "cdeistopened", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Export markdown files to Notion with proper rich text formatting. Use when staging articles, drafts, or documentation in Notion. Handles bold, italic, links, headers, bullets, numbered lists, and code blocks." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/cdeistopened/skill-stack", "path": "public/skills/notion-export/SKILL.md", "ref": "HEAD", "url": "https://github.com/cdeistopened/skill-stack/blob/HEAD/public/skills/notion-export/SKILL.md", "key": "cdeistopened/skill-stack/public/skills/notion-export/SKILL.md" } }, "instructions": "# Notion Export\n\nConverts local markdown files to Notion pages with full rich text formatting preserved.\n\n## Quick Start\n\n```bash\n# Create new page under a parent\npython3 ~/.claude/scripts/notion_markdown.py draft.md --parent-id <page_id> --title \"My Article\"\n\n# Update existing page (replaces content)\npython3 ~/.claude/scripts/notion_markdown.py draft.md --update <page_id>\n\n# Search for a parent page\npython3 ~/.claude/scripts/notion_markdown.py draft.md --search \"Guest Contributors\"\n```\n\n## When to Use\n\n- Staging article drafts for team review\n- Exporting documentation to Notion workspace\n- Sy", "cost": { "context_tokens": 598 } }

notion-export

About