Annotations and Notes
Select text to open the selection toolbar and record a highlight, strikethrough, or Note.
Annotation types
| Type | Typical use |
|---|---|
| Orange highlight | Important or needs attention |
| Green highlight | Approved or confirmed |
| Yellow highlight | Uncertain or needs confirmation |
| Strikethrough | Outdated or proposed for removal |
| Note | Written feedback attached to any selection |
Selections that cross paragraphs, list items, or table cells are stored as ordered fragments while remaining compatible with older single-fragment anchors.
Selection toolbar
The toolbar appears after mouse or touch selection. a temporarily disables it for native selection and copying; Esc clears the selection. When Edit or Chat is enabled, the toolbar also offers source editing and selection-aware questions.
Reading and editing Notes
Wide screens use margin cards; narrow screens use source-adjacent popups. Clicking a source highlight locates its Note. Editing happens in place, and a single local quote plus Note can be copied as Markdown. Opening a Note inside a folded section expands it temporarily and restores the fold when closed.
Undo, redo, and navigation
Ctrl/Cmd+Z undoes; Shift+that shortcut or Ctrl/Cmd+Y redoes. Ctrl/Cmd+J/K moves between annotations. The unified undo stack holds up to 50 operations.
Persistence and permissions
annotation.sqlite is the only annotation authority; there is no LocalStorage fallback. With Shared off, an explicit admin session can read and write review state. With Shared on, administrators and unlocked collaborators use the same dataset, and successful HTTP writes are broadcast over WebSocket. Failures remain explicit and the page stays read-only.
Annotations are associated with absolute file paths, so moving a file changes the association.
Clear, export, and print
The footer can clear a file's annotations after confirmation. H1 and section actions can export Notes, and print output retains highlights, strikethrough, and Notes. Diff pages support the same annotation workflow. See Shared annotations and Data and privacy.