Skip to content
N2O Docs

First Sync

After connecting Notion, the Setup Wizard configures what to sync and where files land. Once the wizard finishes, you’re ready to sync - no additional setup required.

The N2O dashboard panel in the Obsidian sidebar

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/).
  • What to sync - either everything, or specific pages and databases you select in the 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 - press Ctrl/Cmd + P and run 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.

N2O discovering pages in your Notion workspace

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 14-day trial

Section titled “Free 14-day trial”

New users get a free 14-day trial with every feature unlocked: two-way sync, automatic syncing in and out, and custom templates, with unlimited databases and up to 300 pages. No credit card required - start it from the N2O Dashboard.

When the trial ends, keep syncing with Pro ($8/mo) or Lifetime ($249 one-time). Both remove the page cap. Without an active license, syncing is paused: your already-synced files stay in the vault, but no new sync runs until you upgrade.

Troubleshooting

Section titled “Troubleshooting”

“0 items synced” - No pages may be selected. Open Obsidian Settings > N2O Sync > Sync > What to sync and check your selection. If you are syncing specific items, click Choose items and confirm items are checked in the 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”