Skip to content
Open Acorny

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.

  1. Open Acorny.
  2. Go to Settings.
  3. Find Export tokens.
  4. Create a token named Obsidian.
  5. Copy the token immediately. It is only shown once.
  6. Open Obsidian.
  7. Go to SettingsCommunity plugins, turn on community plugins if prompted, and browse the community plugin directory.
  8. Search for Acorny and install the Acorny Sync plugin, then enable it.
  9. Open the Acorny Sync plugin settings.
  10. Paste the export token into the token field.
  11. 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.

  • 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.

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.

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.