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.
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.
Filter tabs
When comments exist, three filter tabs appear at the top:| Tab | Shows |
|---|---|
| All | All comment threads |
| Open | Unresolved threads only |
| Resolved | Resolved threads only |
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.When a comment anchor is removed (e.g., by deleting the line), the comment is not automatically deleted. It remains in the sidebar but is grayed out with an amber “Removed from document” warning. You can still read it, but replying is disabled. To fully remove it, delete the thread manually via the menu.