Installation

N2O Sync Lite is in Obsidian’s community store. One button, and Obsidian opens on the install screen.

Add to Obsidian Open the plugin page

Or find it by hand: Settings > Community plugins > Browse, search N2O Sync Lite, then Install and Enable.

After enabling it, open the panel from the ribbon icon and you will see the connect screen:

Lite, and the full plugin

There are two editions, and Lite is the one in the store. It pulls your Notion pages and databases into plain Markdown, with working links, downloaded media and frontmatter you can query. It does not push anything back to Notion, and it stops at 100 notes in a vault.

	N2O Sync Lite	N2O
Direction	Notion to Obsidian	Both ways
Notes	Up to 100 per vault	No limit
Price	Free, forever	14 days free, then Pro or Lifetime
Install	The button above	From inside Lite, or from GitHub

Move up to the full N2O

From inside Lite. Lite has an upgrade panel that fetches the full plugin from GitHub and installs it for you. This is the shortest path and the one to use if Lite is already running.

With BRAT, if you would rather it updated automatically alongside your other beta plugins:

1. Install BRAT from Obsidian’s community plugins.
2. Open BRAT settings and click Add Beta Plugin.
3. Enter https://github.com/n2osync/n2o.
4. BRAT installs N2O and keeps it up to date.

By hand, if you prefer to see exactly what lands in your vault:

1. Open the latest release.
2. Download all three files:
   • main.js, the plugin code
   • styles.css, the plugin styles
   • manifest.json, the plugin metadata
3. Create the folder .obsidian/plugins/n2o/ in your vault.
4. Copy the three files into it.
5. Restart Obsidian and enable N2O under Settings > Community plugins.

The full edition is not in the community store yet. Two-way sync is a larger review than a one-way plugin, and Lite going in first is what made the store route possible at all.

System requirements

• Obsidian 1.12.4 or later, desktop only, on Windows, macOS or Linux
• The Obsidian installer 1.9.10 or newer (N2O 1.6.19 and later)
• A Notion account, connected with OAuth or an integration token
• An internet connection, for talking to Notion’s API

Note

1.12.4 is the minimum the plugin’s manifest declares, so Obsidian refuses to enable N2O on anything older. Database views are generated as Obsidian Bases files; Bases is a core plugin that arrived in Obsidian 1.9, so every supported version already has it.

The Obsidian installer

N2O 1.6.19 keeps its sync data in the SQLite engine built into Obsidian, and that engine comes with the Obsidian installer, version 1.9.10 or newer. Obsidian updates the app by itself but never the installer, so an app that is fully up to date can still sit on an older installer. You can see yours in Settings > General, next to the app version.

On an older installer N2O does not start. It shows N2O needs a newer Obsidian installer with a download button, and nothing is synced or changed. The fix is one step: download the installer from obsidian.md/download, install it over the one you have (your vaults and settings stay), and restart Obsidian.

Next steps

Once it is installed, connect your Notion account.