VS Code → Notion Sync

Sync your markdown files to Notion pages using Figma embeds and images as anchors.

Features

• Sync the active file's content to a Notion page
• Uses Figma embeds and images as section anchors
• Supports markdown formatting (bold, italic, strikethrough, code, links)
• Supports headings (H1-H3) and todo blocks
• Updates existing content in-place

Requirements

• Python 3 installed and available as python3
• Python packages: Install with:

  pip install notion-client python-dotenv
  

Setup

1. Create a Notion Integration:

   • Go to Notion Integrations
   • Click "New integration"
   • Give it a name and select your workspace
   • Copy the "Internal Integration Token"

2. Share your Notion page with the integration:

   • Open your Notion page
   • Click "Share" → "Invite"
   • Select your integration

3. Configure the extension:

   • Open VS Code Settings (Cmd+, or Ctrl+,)
   • Search for "Notion Sync"
   • Paste your token in the "Notion Token" field

Usage

1. Open the Notion Sync sidebar (cloud upload icon in the activity bar)
2. Open a markdown file you want to sync
3. Paste your Notion page URL
4. Click "Sync to Notion"

File Format

Your markdown file should use Figma URLs or images as section anchors:

# Page Title

Content at the top of the page...

https://www.figma.com/file/abc123/Design?node-id=1:2

This content appears after the first Figma embed.

![](https://example.com/image.png)

This content appears after the image.

## Heading 2

More content with **bold** and *italic* text.

- [ ] Unchecked todo
- [x] Checked todo

License

MIT