README file from
GithubAnnotations Everywhere
Annotations Everywhere adds editable margin notes to Markdown and anchored annotations to PDFs in Obsidian. It keeps annotation data inside the vault so the same notes can travel across desktop and mobile devices.
Features
- Render Markdown footnote definitions as editable, scroll-synced sidenotes.
- Highlight selected PDF text or rectangular regions, including formulas and figures.
- Keep notes in left or right margin rails, or place them freely on the page.
- Share one annotation collection across multiple compatible PDFs, such as an original paper and its translation.
- Search, filter, sort, copy, move, delete, and recover annotations from a vault-wide manager.
- Organize annotations with colors, named layers, native or manual outlines, and single- or double-column reading order.
- Use mobile-friendly controls and an optional palette after selecting PDF text.
- Store annotations as plain vault files, with an optional revision-file format designed to reduce sync conflicts.
Quick start
Markdown sidenotes
Use ordinary Markdown footnotes:
The claim needs more context.[^context]
[^context]: This definition can appear as an editable sidenote in the right margin.
The margin width and gap can be adjusted in the plugin settings or by dragging the aligned margin boundary.
PDF annotations
Open a PDF and use the command palette to:
- add a note to the left or right rail;
- add a freely positioned note;
- create a highlight without a visible note box;
- open the current PDF annotation panel;
- open the vault-wide annotation manager;
- add a compatible PDF to the current shared annotation group.
Text annotations retain the selected quote. Rectangular selections can be used for formulas, figures, or scanned content that cannot be selected as text.
Annotation data and sync
The default annotation directory is .annotations-everywhere/ inside the vault. You can choose another vault folder in the plugin settings.
Annotations Everywhere does not modify the PDF file itself. It does not use telemetry or remote services. Your existing vault sync tool is responsible for transferring the annotation files between devices.
For devices that may edit annotations at the same time, the plugin can migrate the annotation store to revision files. Complete synchronization on every device before starting that migration, and stop older plugin versions from writing the legacy annotations.json file.
Installation
Community directory
Once the plugin is listed, install Annotations Everywhere from Settings -> Community plugins -> Browse.
Manual installation
Download main.js, manifest.json, and styles.css from the matching GitHub release and place them in:
<vault>/.obsidian/plugins/annotations-everywhere/
Restart Obsidian, then enable Annotations Everywhere under Community plugins.
Compatibility
- Minimum Obsidian version: 1.5.8
- Desktop and mobile are supported.
- PDF features rely on Obsidian's built-in PDF viewer. Viewer internals can change between Obsidian releases, so PDF interaction should be rechecked after major app updates.
Privacy
The plugin reads Markdown and PDF files selected through Obsidian and writes its settings and annotation data to the vault. It makes no network requests and collects no analytics.
Development
npm install
npm run build
The production build outputs main.js in the repository root.