Skip to main content

Highlighting & Annotations

Highlight important passages, add notes, and export your annotations to external tools.

Creating Highlights​

  1. Select text in the reader
  2. A floating toolbar appears with options:
    • Color picker — Choose from 6 colors (yellow, green, blue, purple, red, orange)
    • Tags — Optionally tag the highlight for organization
    • Note — Add a personal annotation
  3. Click Save Highlight to persist

Highlights work in article, PDF, and EPUB readers. Each reader uses a position format appropriate to the content type (scroll position for articles, bounding rectangles for PDFs, CFI strings for EPUBs).

Managing Highlights​

In the Reader​

  • Highlights are visually applied to the text
  • Click the Highlights button in the reader header to open the highlights sidebar
  • From the sidebar, jump to any highlight, edit the note, or delete it

Highlights Page​

Visit /highlights for a unified view of all your highlights across all articles:

  • Search across highlight text
  • Filter by color to find specific categories
  • Filter by tag for thematic grouping
  • Bulk select for batch operations (delete, tag)

Exporting Highlights​

Export your highlights from the Highlights page using the Export button. Available formats:

FormatDescription
MarkdownFlat list of highlights with article titles
Markdown (grouped)Highlights organized by source article
ObsidianMarkdown with YAML frontmatter and [[wiki links]] for Obsidian vault integration
JSONStructured data for programmatic use
PlaintextClean text without formatting
ZIPArchive containing all formats

Obsidian Export​

The Obsidian format is designed to drop directly into an Obsidian vault:

  • YAML frontmatter with title, author, URL, and tags
  • Highlights formatted as blockquotes with color indicators
  • Notes appear below their associated highlight
  • Wiki-link references for cross-article connections

See Obsidian Integration for setup details.

AI-Suggested Highlights​

Subscribers receive AI-generated highlight suggestions that surface connections across their library. These appear on the Insights page.

When you accept a suggested highlight, it becomes a regular highlight — visible on the Highlights page and included in exports.

Tips​

  • Use consistent colors for categories (e.g., yellow for key ideas, blue for quotes, red for disagreements)
  • Add tags to highlights to build a searchable knowledge base
  • Use notes to capture your own thinking alongside the author's words
  • Export regularly to Obsidian to keep your vault in sync