Comments and captions
Some remarks belong beside the text rather than in it: a question about a sentence, a reminder to check a figure, a note about where a photo was taken. Comments and captions keep those apart from what you’re writing, and stay in the file when you send it somewhere else.
Add a comment
Select the words the comment is about and choose Format › Add Comment… (⌘⌥A), or right-click and choose the same. With nothing selected, the comment attaches to the point where your caret is.
Commented text is underlined with dots and carries a small speech-bubble badge. Click the badge to read the comment, edit it, or delete it. Hovering over the text shows the comment as a tooltip.
Right-click inside commented text for Edit Comment… and Delete Comment. In a read-only note the menu offers Show Comment… instead.
See every comment
View › Toggle Comments opens the Comments tab of the note’s information popover, the ⓘ button at the top of the note. It lists every comment in reading order, each under the text it’s attached to, or the line it sits in for a comment at a point. Hold the pointer over one to see the heading it’s under, and click it to select its text in the note, unfolding the section if it’s folded.
How comments are stored
A comment is ordinary Markdown, in the CriticMarkup style other tools understand:
The deposit is {==£450==}{>>check this against the contract<<} in total.
A comment with no anchor is just the second half: {>>ring the landlord<<}.
That means a comment survives export, sync and any editor you open the file in. Comments are left out of note titles, excerpts and word counts.
When the text is deleted
Delete commented text and the comment isn’t lost: it moves to Detached Comments at the bottom of the Comments tab (View › Toggle Comments), with the words it used to be attached to and the date it came loose.
From there you can Reattach it to a new selection, Copy it, or Discard it. Varlig keeps the 50 most recent.
Image captions
Right-click an image and choose Edit Caption… to describe it. The caption shows under the image while you write, and travels into PDF, HTML and Word exports.
A caption is the image’s Markdown title, so it stays readable anywhere:
The caption appears under the picture only when the image is alone on its line; an image inside a sentence keeps its caption as a tooltip. Captions are not part of a plain-text export.