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