notion-public-site

Download Notion Site

Download all content from a public Notion site as Markdown files.

Arguments

• $ARGUMENTS should contain: <url> <output_dir> [--test]

Instructions

Run the Notion downloader script:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/notion_public_site_downloader.py $ARGUMENTS

If httpx or playwright are not installed, install them first:

pip3 install httpx playwright
python3 -m playwright install chromium

Features

• Automatically crawls all internal pages starting from the base URL
• Downloads embedded images to attachments/ folder
• Converts Notion content to clean Markdown
• Rewrites internal links as Obsidian wikilinks
• Creates an index file with table of contents
• Use --test flag to download only the first page for testing

Verification Steps

After download completes, verify the content:

1. Count verification: Compare number of downloaded pages against expected (check _page_map.json)
2. Content spot-check: Use Playwright to open 2-3 random pages and compare visible content with downloaded markdown
3. Link verification: Confirm wikilinks in markdown files point to existing files
4. Image verification: Confirm images in attachments/ folder are valid and referenced

Example Usage

# Test mode - download first page only
/download:notion-public-site https://guide.sillymoney.com/ ./output --test

# Full download
/download:notion-public-site https://guide.sillymoney.com/ ./output