rsun-notion-sync

Run the sync-to-notion.py script with the markdown file path as an argument. It converts the markdown to Notion blocks, creates a child page under the configured parent page, and appends the content in batches, returning the Notion URL when done.

The sync script parses markdown and maps tables, code blocks, quotes, and inline formatting to their Notion block equivalents. Code blocks are uploaded as plain text by default, so mermaid diagrams need their language manually switched to Mermaid in Notion afterward.

Yes, the Notion API limits append requests to 100 blocks per call. The script handles this by batching appends in groups of 90, and nested children within blocks also count toward the limit, with failed chunks written to /tmp for debugging.

Notion education accounts on school-managed workspaces typically cannot create internal integrations because the workspace admin locks that capability. The workaround is to use a personal Notion workspace, where internal integrations can be created and connected to pages.

If the NOTION_TOKEN stored in ~/.claude/.env expires or is revoked, visit notion.so/my-integrations, open the integration, copy the new token, and update the environment file. The sync script reads the token from that file at runtime.