Writing

Comments

Leave comments for collaborators right where they matter. Comments are for people; if you want to leave an instruction for an AI agent, use an AI note instead.

Adding a comment

Select the text you want to comment on, then press the Add comment button in the floating toolbar (or use Review > Add Comment, Option+Cmd+M). A composer opens with your selected passage quoted above it. Write your comment and press Comment.

You can also leave a general comment on the whole document: use Add Comment with nothing selected.

What it looks like

A commented passage gets a thin underline in the document. Unread comments show a gold underline; selecting a thread highlights its passage. A small bubble marker next to the passage shows the comment count.

The Comments panel

The right sidebar switches between Edits and Comments lenses. The Comments lens shows every thread: reply, Resolve a thread when it's settled, or Reopen it if the discussion isn't done. A checkbox lets you show or hide resolved threads.

Where comments live

• In a workspace shared through stet sync, comments sync to your collaborators. Everyone on the workspace sees the same threads, with unread counts.
• In a private workspace, comments still work as notes to self. They stay on your machine.

Comments work on any markdown file.