Comments Panel

The Comments panel () lets you add inline comments to specific lines in your document. Comments are anchored to the content and stay in sync as you edit. Use them to leave feedback, ask questions, or coordinate with collaborators.

---

​

Creating a comment

To add a comment, hover over the area between the line number and the text in the editor. A button appears on the current line. Click the button to open the Add Comment modal. The modal shows the target line number and a text field for your comment. Press ⌘ + Enter (or Ctrl + Enter) to submit, or click Add Comment. The comment is now anchored to that line and appears in the sidebar.

---

​

Comment anchor placement

Comment anchors are invisible markers embedded directly in your Markdown source. Where exactly the anchor is placed depends on the type of content you comment on:

• Single-line elements (headings, paragraphs, list items, etc.) — the anchor is inserted on the same line, at the end of the text.
• Multi-line elements (code blocks, tables, lists, blockquotes, etc.) — the anchor is placed on a new line directly below the element. Commenting on any item within a list or any row within a table will place the anchor after the entire block. This is because inserting a marker inside a multi-line block would break its syntax.

​

Anchor movement during editing

Because anchors live inside the document text, they behave like any other character when you edit around them:

• Pressing Backspace at the beginning of the line below the comment icon will delete the anchor. This happens because the anchor marker is stored at the end of that line — pressing Backspace merges the lines and removes the anchor in the process.
• Deleting lines above the anchor shifts it upward.
• Adding lines above the anchor shifts it downward.

This means the comment may appear to “move” to a different line after edits — it is still attached to the same position in the text, but the line number changes as surrounding content shifts.

---

​

Viewing comments

The sidebar lists all comment threads for the current document. Each card shows the author’s avatar, name, timestamp, and the comment text. Only the comments of the selected (expanded) thread are fully visible. Collapsed threads show a reply count if they have replies — click a thread to expand it.

​

Filter tabs

When comments exist, three filter tabs appear at the top:

---

​

Navigating between editor and comments

Comments and the editor are linked bidirectionally:

• Sidebar → Editor: Click a comment thread in the sidebar to jump to the corresponding line in the editor. The editor scrolls to and highlights that line.
• Editor → Sidebar: Lines with comments show an amber icon in the gutter. Click it to open the Comments panel and select that thread.

---

​

Thread actions

Hover over a comment thread and click the menu to access actions:

• Resolve — marks the thread as resolved. Resolved threads appear grayed out and move to the Resolved filter tab. You can reopen a resolved thread from the same menu.
• Delete — permanently removes the thread (only available for your own comments).

​

Replies

When a thread is expanded (selected), a reply input appears at the bottom. Type your reply and press Enter to send. You can also use quick emoji reactions (👍 ❤️ 🎉 👀) via the button when the input is empty.

---

​

Orphan comments

Comment anchors are embedded in your document as hidden markers. If you delete the line that contains an anchor, the comment loses its position in the document.