User Documentation
Sync to Obsidian
Use Obsidian sync when you take notes in Obsidian and want your Acorny highlights to appear in your vault as Markdown notes automatically.
Obsidian sync is one-way: highlights flow from Acorny into Obsidian. Edits you make inside Obsidian do not change your Acorny library.
The sync is set up inside Obsidian with the official Acorny Sync plugin. In Acorny, you only create an export token.
- Open Acorny.
- Go to Settings.
- Find Export tokens.
- Create a token named
Obsidian. - Copy the token immediately. It is only shown once.
- Open Obsidian.
- Go to Settings → Community plugins, turn on community plugins if prompted, and browse the community plugin directory.
- Search for
Acornyand install the Acorny Sync plugin, then enable it. - Open the Acorny Sync plugin settings.
- Paste the export token into the token field.
- Save the settings and run a sync.
After setup, the plugin pulls new highlights from Acorny on its sync schedule and writes them into your vault as Markdown notes.
What syncs
Section titled “What syncs”- Highlights from your Acorny library
- Notes attached to highlights
- Tags attached to highlights
Sync is incremental: after the first run, the plugin only fetches highlights that are new since the previous sync.
Token safety
Section titled “Token safety”Export tokens are read-only: they can read your highlights but cannot create or change anything in Acorny. Store them like passwords anyway. If a token is exposed, revoke it in Settings and create a new one. Do not commit your Obsidian vault data folder to a public repository — plugin configuration may contain this token.
Troubleshooting
Section titled “Troubleshooting”If highlights do not appear in Obsidian, check the following:
- Confirm the token field contains an Acorny export token, not an Import API token and not your Acorny login password.
- Create a fresh export token and reconfigure the plugin if authentication fails.