Use Relay Comments to discuss a passage in your notes. Comments and replies stay in the Markdown file.
Install Relay Comments and open a Markdown note. To add comments or change review items, you need write access to the note.
Use Live Preview to select text and the review sidebar to discuss it. You can also read comments in Reading mode.
The thread appears in the sidebar, with the selected passage attached to it.
You can also right-click the selected text and choose Add comment.
When your selection includes Markdown markers for a heading, list item, task, blockquote, or callout, Relay Comments keeps that Markdown syntax outside the comment’s highlight.
If your selection extends into a later list item, task, blockquote line, or heading, select the passage within one block and try again.
If the selected passage overlaps another review mark or extends into another list item, task, blockquote line, or heading while your draft is open, Relay Comments keeps the draft text and displays The commented text changed; select it again.
If Add comment asks you to edit a rendered table first, open the table for editing and select text inside a cell.
If the selection includes a link label or inline code, or the comment command asks you to edit the callout first, choose Edit this block and select the passage in the Markdown source.
Your reply appears in the thread.
Resolving a Markdown comment thread removes the discussion's comment markup from the note. It keeps the passage's text. A CriticMarkup highlight used to anchor the discussion becomes plain text; an Obsidian native highlight remains highlighted.
If the discussion is attached to a suggestion, resolving the discussion leaves the suggestion for a separate accept-or-reject decision. If you use Resolve on a suggestion without a discussion, it accepts the suggestion.
The sidebar lists the note's comments, suggestions, and highlights. To open the sidebar, run Open review sidebar from the command palette. To close it, run Close review sidebar.
If someone writes a comment directly in the Markdown without marking a passage, the sidebar uses nearby text to identify it. For example, a comment immediately after the word “bridge” shows bridge above the message. A comment at the start of a line shows Comment instead.
For comments inside rendered tables and callouts, hover over the highlighted text to preview the thread, or select it to open the thread in the sidebar.
To add a comment to selected text, press Command+Option+M on macOS or Ctrl+Alt+M on Windows and Linux. The shortcut also works for selected text inside Canvas notes and native text cards. On a Canvas without a focused text editor, Add comment starts pin placement.
Give your agent the Relay Comments skill, the note path, and the passage you want it to comment on. For example: “In Launch plan.md, ask who owns the announcement beside ‘Draft announcement.’”
With the Obsidian CLI enabled, the agent can run:
obsidian vault="Work" comments:comment path="Launch plan.md" quote="Draft announcement" text="Who owns the announcement?"