Repository navigation
1.0.0
First public release.
What it does
Comments on a selection or on a whole line, without ever modifying the note. Comments live in .margin-comments/ at the vault root, so your Markdown is exactly what you wrote.
- Threads, one level of replies deep. Edit, resolve, reopen and delete — and a delete names the replies it takes with it before it happens.
- In the editor: highlighted text, a tint on commented lines, and gutter markers that carry a count when a line holds several threads. A popover opens beside the line, or the panel takes over when it is open.
- In the sidebar: filter by all, open or resolved; sort by document order, date created or last activity; and an all-notes view listing every commented note in the vault.
- In reading mode: commented text is highlighted, and a tap or click opens its thread.
- Commands to add a comment, jump between comments, resolve every thread in a note and toggle the panel. None takes a default hotkey, so none collides with yours.
- On a phone: markers that do not need hover, thumb-sized controls, and a composer that stays above the on-screen keyboard.
- Keyboard and screen reader access to every control, with colours and type taken from your theme.
Comments that stay put
Anchoring is by content, not by line number, in three stages: an exact hash, then the surrounding text, then a bounded fuzzy match whose tolerance you set. So a comment survives the note being edited above it, reformatted, or rewritten around it.
- Comments follow their note through renames and moves, including a rename made outside Obsidian, and come back whenever a deleted note does — they are held on disk, so a restart does not lose them.
- Damaged storage is never overwritten. An unreadable sidecar or an invalid comment is set aside in a kept file and a notice says where.
Security
Comment bodies are treated as less trusted than your own notes, because in a shared vault whoever can write a sidecar can write a body. They are rendered in a document with no browsing context and cleaned before anything reaches the card, so a body cannot reach the network — no image, srcset, <picture>, <video>, <iframe>, SVG <image>, CSS url(…) or background attribute phones home. See SECURITY.md.
Requires
Obsidian 1.13.4 or newer, desktop and mobile. That is the oldest release the full end-to-end suite passes on, measured rather than guessed.
Installing manually
Drop main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/margin-comments/ and enable the plugin in Settings → Community plugins.
Full notes in CHANGELOG.md.