Repository navigation
Releases
1.2.0
Added
- Restore held comments to this note... lists the comments set aside for notes that went
missing (old path, open threads, last update) and restores the chosen set to the active
note. Nothing is removed until the note holds them (#432).
Fixed
- A note edited between two moves made outside Obsidian keeps its comments: when it is the
only candidate with the same file name, it gets them all, and the ones whose text changed
show as orphaned threads instead of staying held (#431). - Comment highlights show inside rendered tables and callouts in live preview, and clicking
them opens the thread (#419). - The comment gutter no longer appears inside a table cell being edited, nor shifts its text (#418).
- The composer and popover open next to a selection inside a rendered table, not at the
window's edge (#420). - "Add comment to selection" comments the words selected in a rendered callout instead of the
whole line. - Inside
==highlight==only the underline is drawn, so the colours no longer blend into brown. - Quotes from table rows show their cells without the pipe syntax in the panel (#422).
1.1.0
Added
- A Storage folder setting chooses where comments are kept. The default stays the hidden
.margin-comments/; a visible name lets Obsidian Sync carry comments between devices
(#401, #404). - Move comments copies every comment file to the new folder, merges it by comment id with
anything already there, and removes the old folder once it is empty. A move that stops
halfway can be run again and loses nothing (#402). - Settings explain what Obsidian Sync needs to carry a visible storage folder (#404).
Changed
- When the storage folder is visible, the plugin ignores it in vault events, and follows it
when you rename or move it from the file explorer (#403). - A shorter listing description that leads with what sets the plugin apart.
1.0.3
1.0.2
1.0.1
Everything the Obsidian community directory's automated review of 1.0.0 raised. No change to what the plugin does.
Added
-
Provenance attestations on
main.jsandstyles.css. You can now verify cryptographically that the files you install were built by this repository's release workflow from this tag:gh attestation verify main.js --repo jonaas-dev/obsidian-margin-comments
Changed
- The
color-mixtints move behind an@supportsblock. They were a fallback written as two declarations in a row, which reads as duplicated properties; the condition is now stated rather than implied. The fallback itself stays — mobile runs the system webview, wherecolor-mixarrived in iOS 16.2. debouncetakes its timers as an argument instead of reaching for the main window's.- Reading mode uses Obsidian's cross-window
instanceOfrather thaninstanceof. - One fewer development dependency:
builtin-modulesis nownode:module.
If you are already on 1.0.0 there is nothing here you need. Full notes in CHANGELOG.md.
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.