Obsidian Stats logoObsidian Stats

Review Comments

by Shota Shirai
5
4
3
2
1
Score: 35/100
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Notion-style review comments stored as CriticMarkup. AI-friendly format for LLM-assisted editing.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Obsidian Review Comments

日本語版 README: README.ja.md

Notion-style review comments for Obsidian. Select text, click the floating button, and add a comment. Comments are stored directly in .md files as CriticMarkup, so Claude / GPT can read the file and apply the requested edits without any export step.

Comment format

The original {==text==}{>>shirai|2026-05-13: please rewrite<<} has an issue.
  • {==...==} — highlighted span (rendered in yellow)
  • {>>author|date: comment<<} — comment metadata

Build

git clone https://github.com/ShotaShirai1719/obsidian-review-comments.git
cd obsidian-review-comments
npm install
npm run build

This produces main.js.

Install

Let $VAULT be the absolute path to your Obsidian vault:

mkdir -p "$VAULT/.obsidian/plugins/review-comments"
cp main.js manifest.json styles.css "$VAULT/.obsidian/plugins/review-comments/"

Or, for development, symlink the working directory:

ln -s "$(pwd)" "$VAULT/.obsidian/plugins/review-comments"

Then in Obsidian:

  1. Settings → Community plugins → enable Review Comments
  2. Settings → Review Comments → set Author name to your own name

Usage

  1. Drag-select a span of text
  2. Click the 💬 Comment button that appears near the selection
  3. The placeholder "コメントを書く" is selected — start typing to overwrite it

Alternatively:

  • Select text → Command palette → Review Comments: Add comment to selection
  • Assign a hotkey (recommended: Cmd + Shift + M)

Side panel

Open the comments panel from the left ribbon (speech-bubble icon) or via Review Comments: Open comments panel.

  • Click a card → jump to the corresponding location in the document
  • Resolve button → replace {==text==}{>>...<<} with text (deletes the comment, keeps the original text)

AI integration

Pass the .md file directly to Claude Code or another LLM with a prompt like:

Apply the edits described in the CriticMarkup comments ({==...==}{>>...<<}) in this file. Remove the CriticMarkup once each comment has been applied, and restore the highlighted spans to plain text.

This closes the loop: comment in Obsidian → hand off to an LLM → get a clean diff back.

Development

npm run dev   # watch mode
npm run build # production build

License

AGPL-3.0-or-later.

Any modified version that you distribute, or expose over a network, must be made available under the same license. If that's a constraint for your use case, please open an issue before integrating this plugin into a closed product.

Sponsors