Comments, tags and backlinks in documents
Select text in a document and comment on it — the comment attaches to that range and shows as a dot in the right margin. Tags applied to a range underline the text and show in the left margin. The app also suggests entity names it notices, which you confirm or dismiss with a tick or a cross, and backlinks show everywhere the document is referenced from.
Documents carry annotation in the margins, so the text stays clean and the apparatus stays visible.
Comments on a range
Select text and add a comment. It anchors to that range, not to a character position, so editing around it keeps it attached to the right passage.
Commented text is marked inline, with a gold dot in the right margin. Click a dot to open the thread.
Comments thread, resolve, and support @ mentions that notify the person you name. See Comments for the full model, which is shared with the canvas.
Tags on a range
A tag can apply to a passage rather than the whole document. Tagged text is underlined, with dots in the left margin.
This is what lets a script's mention of a location connect to the reference wall for that location — the tag's detail view will list this passage among everything else carrying it.
Suggested entities
As you write, names that look like entities — characters, locations, organizations — are detected and offered in the margin with a tick and a cross.
Nothing is applied until you accept it. A suggestion is a suggestion; the document is not silently tagged behind you.
Accepting one creates or links the entity, so the next occurrence anywhere is recognised automatically.
The detector is on by default and can be switched off in settings if you would rather work without it.
Links and mentions
Type @ to reference a cluster, document, card, tag or person. Mentions render as links with hover previews and register as backlinks on the target.
URLs typed or pasted become links automatically.
See Links and mentions.
Backlinks
The Referenced by panel lists everywhere this document is linked or mentioned from — other documents, notes, cards, messages.
Backlinks are the reason mentioning things is worth the keystroke: a location's entity page ends up listing the script scene, the reference board and the message thread that all pointed at it, without anybody maintaining an index.
Bookmarks
Not annotation but adjacent: bookmarks are durable anchors into specific places in a document, listed in the right pane. They survive edits around them, so a bookmark on "the end of act two" stays there as the act changes length.
Frequently asked questions
What happens to a comment if I edit the text it is attached to?
It follows the text. Comments anchor to the range, not to a character offset, so editing around them keeps them attached to the right passage.
What are the dots in the margins?
Right margin is comments. Left margin is tags and suggested entities. Click one to open it.
Can I turn off the entity suggestions?
Yes. The AI tagger is on by default and can be switched off in settings. Suggestions never apply themselves — nothing is tagged until you accept it.
Machine-readable: /docs/documents/comments-and-tags.md · /llms.txt