Skip to content
N2O Docs

First Sync

After connecting Notion, the Setup Wizard configures your sync scope and folder. Once the wizard finishes, you’re ready to sync — no additional setup required.

After the Setup Wizard

Section titled “After the Setup Wizard”

The wizard handles the essentials:

  • Sync folder — where synced files are placed in your vault (default: Notion/).
  • Sync scope — either your entire workspace, or specific pages and databases you select in the tree picker.

When you complete the wizard, these settings are saved automatically.

Running Your First Sync

Section titled “Running Your First Sync”

Start your first sync using any of these:

  • Dashboard — open the N2O sidebar panel and click Sync.
  • Ribbon icon — click the N2O icon in the left sidebar.
  • Command Palette — Ctrl/Cmd + P → N2O: Sync with Notion.

The status bar at the bottom of Obsidian shows sync progress.

What Happens During Sync

Section titled “What Happens During Sync”

N2O queries your Notion workspace, discovers all pages and databases in scope, and downloads their content. The first sync fetches everything — large workspaces (hundreds of pages) may take a few minutes due to Notion’s API rate limits. Subsequent syncs are incremental: only changed pages are re-fetched.

After Sync

Section titled “After Sync”

Your sync folder will contain one file per Notion page:

Notion/                         ← your sync folder
├── My Database/                ← one folder per database
│   ├── Item One.md
│   ├── Item Two.md
│   └── _files/                 ← media downloaded from database items
├── My Database.base            ← Bases view (table, cards, list)
├── _Pages/                     ← standalone pages
│   ├── Project Overview.md
│   ├── Meeting Notes/
│   │   ├── Meeting Notes.md
│   │   ├── 2026-01-10.md
│   │   └── 2026-01-15.md
│   └── _files/

Every file includes YAML frontmatter with Notion properties and sync metadata:

---
icon: "📋"
status: "In Progress"
tags:
  - frontend
  - feature
notion_id: "abc123..."
notion_url: "https://notion.so/..."
created: 2026-01-15T09:00:00.000Z
updated: 2026-03-01T14:30:00.000Z
n2o_type: "database-item"
---


# My Project


Page content appears here as Markdown...

Free Tier

Section titled “Free Tier”

On the free tier, sync is pull only (Notion → Obsidian), supporting up to 100 pages with unlimited databases. Push sync (Obsidian → Notion) and auto-sync require a Pro license. A 14-day Pro trial is available from the N2O Dashboard.

Troubleshooting

Section titled “Troubleshooting”

“0 items synced” — No pages may be selected. Open Settings → N2O → Sync Configuration and verify your scope. If using “Selected Pages”, confirm items are checked in the tree picker.

Pages missing — With a manual token, the page may not be shared with your integration. See Connect Notion.

Sync seems slow — The first sync fetches everything from scratch. 500+ pages can take several minutes due to Notion’s rate limit. This is expected behavior.

Next Steps

Section titled “Next Steps”