Skip to content

Comments

Jump to bottom
Josh Glazer edited this page Jul 11, 2026 · 1 revision

Comments

Comments are freeform notes attached to your text, independent of annotations. They can carry a tag (reusing the same identifier styles as annotations) or be left untagged.

Syntax

{@your comment@}
{@{identifier}your comment@}
{@{parent/child}your comment@}
  • Untagged — {@your comment@} — no identifier, shown with the fallback Comment content color if configured.
  • Explicitly tagged — {@{identifier}your comment@} or {@{parent/child}your comment@} — colored using that identifier's style, same as annotations.

Do not leave a space between the {@ (or {@{tag}) and the comment text.

Tag inheritance (adjacency)

A comment with no explicit tag automatically inherits the tag of an annotation that ends exactly where the comment begins — zero-space adjacency, forward only:

{={math/cold}dark energy=}{@double-check this against the 2023 paper@}

Here the comment inherits math/cold even though no tag is written in the comment itself. A single space (or any other gap) between the annotation and the comment leaves the comment untagged.

This is also why the Comment & annotate command (below) inserts a bare {@@} rather than repeating the identifier — the adjacency rule already resolves the tag.

📷 Screenshot placeholder: an annotation immediately followed by a tag-inheriting comment, in Live Preview and Source Mode.

Commands

Command Description
Show comments sidebar Toggle the comments sidebar open/closed
Add comment Insert a comment at the cursor (or wrap the selection). Prompts for a tag from the same list as Apply identifier to selection (pick "No tag" for an untagged comment) — unless the cursor is immediately after an annotation and Auto-inherit adjacent tag is on, in which case the prompt is skipped and the annotation's tag is inherited
Comment & annotate Wraps the current selection as an annotation and inserts an empty, adjacent, untagged comment ({@@}) right after it in one step — the comment inherits the annotation's tag via adjacency. Shows a notice if no text is selected
Toggle comment bracket visibility Show or hide the {@ and @} delimiters in Live Preview
Toggle comment bracket formatting Enable or disable the tag color on the bracket portion
Toggle comment text visibility Hide the entire comment — brackets and text
Toggle comment text formatting Enable or disable the tag color on the comment text

Comments sidebar

Open via the Show comments sidebar command.

  • Lists comments in the currently open note, grouped by resolved tag (explicit or inherited); switches automatically as you move between notes
  • Untagged comments are collected into a trailing No Tag section, expanded by default — every other section starts collapsed
  • A search box filters comments by text
  • Click any entry to select the full source line and place the cursor at the start of that comment's marker
  • Use Expand all / Collapse all buttons to show or hide all groups
  • A quick-toggle button panel (SB, C-V, C-F, B-V, B-F) sits at the bottom — see Configuration#sidebar-settings

📷 Screenshot placeholder: the Comments sidebar open on a note, showing the tagged groups, the "No Tag" section, and the search box.

Styling

Comments reuse the same identifier styles as annotations (see Annotations#styling-identifiers) when tagged. For colors that apply regardless of tag — the delimiter glyphs themselves, or text with no resolved tag — see Comment delimiter / Comment content in Configuration#comments-settings.

Example

This approach {={math/hot}maximizes the posterior=} under the prior.{@double-check this against the 2023 paper@}
A quick note with no tag: {@remember to revisit this section@}

Clone this wiki locally