Get AI summaries of any video or article — Sign up free
Exclusive interview with Readwise on the new Readwise to Obsidian plugin | LYT House Episode 4 thumbnail

Exclusive interview with Readwise on the new Readwise to Obsidian plugin | LYT House Episode 4

5 min read

Based on Linking Your Thinking with Nick Milo's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Readwise’s Obsidian plugin is designed for ongoing highlight syncing, not one-time export.

Briefing

Readwise’s new “Readwise to Obsidian” plugin is built to keep highlight notes continuously up to date inside Obsidian without destroying what users already wrote. The core promise is “append only” syncing: when new highlights arrive, the plugin adds them at the bottom of the relevant note rather than overwriting earlier content—an approach designed to protect the most valuable part of a knowledge workflow: personal connections, links, and annotations added after the initial import.

The integration starts with a one-time setup that connects Obsidian to Readwise, then runs a sync to export existing highlights. For heavy users, the export can take minutes—one example cited roughly 35,000–36,000 highlights—so the plugin includes manual sync controls and command-palette access (e.g., running sync from Obsidian’s command palette). After the initial import, the plugin’s behavior is what differentiates it from older “export once” approaches like markdown zip exports: it’s designed for ongoing reading, where new highlights keep coming in.

A major feature is customizable formatting via a templating engine (Jinja2). By default, the plugin can output highlights using simple structures, but power users can toggle on a full templating system to control the exported markdown, including YAML front matter, page metadata, highlight layout, and how highlight text becomes blocks in Obsidian. The plugin also generates “page metadata” fields such as author, full title (including subtitle handling), category (book/article/podcast/tweet), document tags, and the original URL—metadata that Readwise interprets from its library and lets users correct when classification is off (for example, PDFs sometimes being interpreted as articles).

The plugin’s “highlights header” and divider logic supports incremental updates. When users take more highlights later, the plugin appends a new timestamped section beneath the existing content, preserving any edits made above. That design directly targets a common fear in syncing workflows: resyncing shouldn’t erase the notes that were written in response to earlier highlights.

Beyond the export itself, Readwise positions the plugin as part of a broader product philosophy. Readwise’s central value proposition is not just syncing highlights into note apps; it’s the “Daily Review” habit that resurfaces highlights over time. To make that work, Readwise must store highlight data in its managed platform, which also shapes how the integration behaves.

The roadmap focuses on the most requested refinements from early public launch feedback. Top items include folder and file naming templating (including non-English preferences), mobile support with safeguards against duplication, additional template variables (such as highlight date handling), and the ability to filter what gets exported (e.g., only books or only tweets rather than exporting everything based on time). There’s also discussion of “bi-directional sync” as a longer-term goal—updating Readwise when users edit notes in Obsidian—though that depends on the technical constraints of note-taking ecosystems.

Overall, the plugin aims to make highlight-to-notes workflows dependable for power users who want control over formatting and metadata, while keeping the most fragile part of the system—user-authored meaning—safe from sync overwrites.

Cornell Notes

Readwise’s official Obsidian plugin imports highlights from Readwise into an Obsidian vault and is designed for ongoing syncing, not one-time export. Its key safeguard is “append only” updates: new highlights are added at the bottom of existing notes so user edits, links, and connections aren’t overwritten. The export is highly customizable through a Jinja2 templating engine, including YAML front matter, page metadata (author, full title, category, tags, URL), and highlight formatting (bullets vs block quotes, embedded links, notes/tags). Readwise also ties the integration to its broader “Daily Review” habit, which requires stored highlight data. Upcoming work targets naming customization, mobile support, export filtering, and more template variables, with bi-directional sync framed as a longer-term goal.

What problem does the plugin solve that older highlight exports couldn’t?

Older markdown export workflows were “export once”: they worked well at import time but didn’t handle what happens after you keep reading and taking new highlights. The Readwise-to-Obsidian plugin is built for repeated syncing, so new highlights can be brought into the vault as they arrive without requiring users to re-import from scratch.

Why is “append only” syncing such a big deal for trust in a personal knowledge system?

Users often edit imported highlight notes—adding links, prompts, and personal interpretations. Overwriting those edits during a resync breaks trust. The plugin avoids that by only adding new content at the bottom of the existing note, typically under a new header with a timestamp, so earlier user-authored material remains intact.

How does the plugin let users control the structure and metadata of exported notes?

A templating engine (Jinja2) drives the markdown output. Users can toggle custom formatting and adjust YAML front matter, page metadata (author, full title, category, document tags, and source URL), and the highlight layout. Highlight formatting can be changed—for example, switching from bullet lists to block quotes—while ensuring proper spacing/newlines so Obsidian renders the blocks correctly.

How does Readwise handle “category” and “document tags” when exporting to Obsidian?

Readwise interprets categories from its library (e.g., tweets as tweets), but users can correct misclassifications. The exported output includes category and document tags, using a hashtag-style convention in the example. The plugin also supports wikilinks for metadata fields like author, and it can include the original URL so users can trace back to the source.

What’s the practical workflow for syncing in Obsidian?

After installing the “Readwise official” community plugin, users click “connect to Readwise,” return to Obsidian, and run sync via “initiate sync” or the command panel. The plugin can run manually or periodically, and it can also auto-sync when the vault is opened. A “resync delete files” option supports refreshing exports after template changes by deleting and re-importing.

What features are most requested for a future version (v2)?

Early feedback emphasized (1) folder and file naming templating so users can change conventions (including non-English naming), (2) mobile support with safeguards to prevent duplication across devices, (3) additional template variables such as highlight date handling, and (4) export filtering (e.g., exporting only books or only tweets rather than everything based on time).

Review Questions

  1. How does the plugin’s append-only behavior change the risk profile of resyncing highlights in Obsidian?
  2. Which parts of the exported markdown are controlled by the Jinja2 templating system, and how can users use it to change highlight rendering?
  3. What roadmap items were identified as the most requested next steps, and why do they matter for different user workflows?

Key Points

  1. 1

    Readwise’s Obsidian plugin is designed for ongoing highlight syncing, not one-time export.

  2. 2

    Sync updates are “append only,” adding new highlights at the bottom to avoid overwriting user edits and connections.

  3. 3

    A Jinja2 templating engine enables deep customization of markdown output, including YAML front matter, page metadata, and highlight formatting.

  4. 4

    The plugin exports structured metadata (author, full title, category, document tags, and source URL) and lets users correct misclassified categories.

  5. 5

    Sync can be run manually, periodically, or automatically when the vault opens, with options to refresh by deleting and re-importing files.

  6. 6

    The v2 roadmap prioritizes folder/file naming templating, mobile support, export filtering, and additional template variables like highlight date handling.

  7. 7

    Readwise’s broader “Daily Review” habit depends on stored highlight data, which shapes how syncing and updates work across apps.

Highlights

The plugin’s defining safety feature is append-only syncing, which preserves personal annotations and links added after the initial import.
Custom formatting isn’t limited to simple toggles; it’s driven by a Jinja2 templating engine that can control metadata and highlight rendering.
Early v2 feedback centered on practical usability: naming conventions, mobile duplication risks, and selective exporting (books vs tweets).
Bi-directional sync is framed as a longer-term “holy grail,” but it depends on technical constraints and note-app ecosystem capabilities.

Topics

  • Readwise to Obsidian Plugin
  • Append-Only Sync
  • Jinja2 Templating
  • Highlight Metadata
  • Daily Review Habit