Skip to content
Multilo Docs

Comments

Pin notes to your text, work through them in the Comments pane, resolve them as you go, and bring in comments from a Word document.

Comments are notes you pin to a piece of your text: a reminder to check a figure, a question for later, feedback from your supervisor. They sit in a pane beside the document, never in the text itself, so they don’t end up in your exported file. Comments from a Word document come across when you import it.

Add a comment

  1. Select the text

    Select the words the comment is about.
  2. Choose Comment

    Click the Comment icon on the bar above your selection, or right-click and choose Comment.
  3. Write and save

    The text is highlighted and the Comments pane opens with a new comment. Type your note, then click Save or press Ctrl+Enter (⌘+Enter on a Mac).

Save the document at least once before you add comments — a new, unsaved document can’t hold them yet. A comment you leave empty is removed when you save or cancel it.

The Comments pane

Open it with the Comments button at the top right of the document, next to Edit. The button shows how many open comments the document has.

Each comment shows:

  • The text it’s about. Click it to jump to that place in the document.
  • Who wrote it and when, for example “You · 5m ago”. Comments imported from Word keep their authors’ names.
  • The note itself, and a Resolved tag once it’s dealt with.

Open comments are listed first, newest at the top. Turn on Show resolved to see resolved ones below them.

Edit, resolve, and delete

ButtonWhat it does
EditChanges the note. Save or cancel when you’re done.
ResolveMarks the comment as dealt with and hides it, unless Show resolved is on.
UnresolveReopens a resolved comment.
DeleteRemoves the comment and its highlight for good.

Work through feedback

Resolve each comment as you fix it, then leave Show resolved off. The count on the Comments button tells you how much is left.

Comments from Word

When you open a Word file with Edit as Markdown, its comments are brought into the Comments pane — see export & import. Multilo keeps:

  • The comment text and its date.
  • The author’s name (a comment with no name is shown as “Word user”).
  • The highlight on the commented words — as long as those exact words appear only once in the document. If they appear more than once, the comment is still in the pane but has no highlight.

Replies in a Word thread come across as separate comments, and every imported comment starts as open, even if it was resolved in Word.

Where comments are saved

The highlight is saved inside your document. The comments themselves — text, author, date, and whether they’re resolved — are saved in a separate file next to it, with the same name plus .comments.json. For example, chapter-2.md keeps its comments in chapter-2.md.comments.json.

If you copy or move the document outside Multilo, take that file with it, or the comments won’t follow.

What comments don’t do yet

  • No replies. Each comment is a single note. To answer one, edit it or add a new comment on the same text.
  • Not exported. Word and LaTeX exports leave comments out. Send feedback separately, or resolve it before you export.
  • Markdown documents only. Comments work in Markdown documents in rich view. A Word file in Word Preview, a PDF, or a spreadsheet can’t hold comments.
  • No shared commenting. Multilo works on files on your computer, so there’s no live commenting with other people. Comments you add are shown as yours.

Troubleshoot

ProblemWhat to do
“Select some text to comment on.”Select the words first, then choose Comment.
“Save this document before adding comments.”Save the document (Ctrl+S), then add the comment.
There’s no Comments buttonThe file isn’t a Markdown document. For a Word file, open it with Edit as Markdown.
Clicking a comment doesn’t jump anywhereThe text it was on has been deleted. The comment keeps a copy of the words; resolve or delete it.
My comments disappeared after moving a fileThe .comments.json file didn’t move with the document. Put it back next to the document with the matching name.