Acorny Sync — bring your reading highlights into Obsidian as Markdown

Disclaimer

Is this project open source? Yes
Is this project completely free? Yes
Is this project vibe-coded beyond the author’s ability to comprehend how it works? No
Community Directory: [Acorny Sync]( Acorny Sync - Obsidian Plugin )


Acorny Sync — bring your reading highlights into Obsidian as Markdown

Hi everyone,

I’ve released Acorny Sync, a community plugin that syncs highlights from Acorny into your Obsidian vault as ordinary Markdown notes.

Community plugin page:

Why I built it

I save highlights from web articles, books, newsletters, and several reading services, but I don’t want those highlights to remain locked inside a separate reading app.

I use Acorny to collect and review highlights, while Obsidian is where I connect them with the rest of my notes.

Acorny Sync connects those two parts of the workflow.

What the plugin does

  • Creates one Markdown note for each source

  • Lets you choose the destination folder in your vault

  • Adds frontmatter including the title, source URL, Acorny source ID, author, and tags when available

  • Supports manual sync, sync on startup, and optional interval-based sync

  • Works on both desktop and mobile

The generated notes remain normal Markdown files, so they can be searched, linked, edited, moved, backed up, or processed by other Obsidian plugins.

It does not overwrite your edits

The synchronization is append-only and idempotent.

Each imported highlight receives a stable Obsidian block ID. When you sync again, the plugin checks which highlights are already present and only appends new ones.

This means that text, links, comments, or other material you manually add to the note will not be replaced during the next sync.

Notes are also matched using their Acorny source ID rather than only their filename. Renaming a generated note will therefore not cause the plugin to create another copy of the same source.

Security and data access

The plugin uses a read-only Acorny export token.

It can download your highlights, but it cannot edit or delete data in Acorny. The plugin only communicates with Acorny’s documented export endpoint and does not upload the other contents of your vault.

The token is stored in the plugin’s local data file, so that file should not be published or committed to a public repository.

What is Acorny?

Acorny is a lightweight tool for collecting, organizing, and reviewing reading highlights.

It can capture highlights from webpages and import existing highlights from sources such as Kindle, Readwise, Instapaper, Cubox, Diigo, Inoreader, WeRead, and Moon+ Reader. Highlights can then be searched, tagged, reviewed with spaced repetition, or converted into active-recall questions and cloze cards.

Acorny is currently free during public beta:

https://acorny.io

An Acorny account is required because the plugin synchronizes highlights from the Acorny export feed.

Installation

  1. Open Settings → Community plugins → Browse in Obsidian.

  2. Search for Acorny Sync.

  3. Install and enable the plugin.

  4. In Acorny, open Settings → Export tokens and create a read-only export token.

  5. Paste the token into the plugin settings.

  6. Run Acorny: Sync now from the command palette or the ribbon icon.

Source code and issue tracker:

I’d particularly appreciate feedback on:

  • How you prefer highlights to be structured inside each note

  • Which frontmatter properties are useful in your workflow

  • Whether you would prefer additional folder or filename templates

  • Any sources or metadata that are not being represented correctly

Thanks for taking a look.