Notion Markdown Sync

Use scripts/notion_md_sync.py to replace a Notion page from a local Markdown post and upload local images as native Notion files. Stdlib only (Python 3.10+).

Workflow

1. Confirm the target page is shared with the Notion integration.
2. Set NOTION_PAT or NOTION_TOKEN in the environment. Never ask the user to paste a token into chat, print it, or store it in the post.
3. Dry run (default; no writes):

python3 <skill-directory>/scripts/notion_md_sync.py \
  push "PAGE_URL_OR_ID" "/path/to/post.md"

4. Review the plan, then apply only after the user approves: