Comments

Comments let readers discuss a specific passage without changing the source note. Open comments are highlighted on the shared page and collected in the Comments panel.

Comments are on by default for shared notes. Anyone with the public link can read visible comments, but a reader must sign in with Google or GitHub before posting.

Leave A Comment

On a desktop browser:

1. Select text in the body of the shared note.
2. Click Comment beside the selection.
3. Sign in with Google or GitHub if prompted.
4. Write your comment and post it.

On a phone, open the Comments panel, tap Add comment, then tap the paragraph you want to discuss.

Comments can be attached to text in the note body. The public title, summary, properties, images, Mermaid diagrams, and page controls cannot be selected for commenting.

Signing in while composing returns you to the same note and restores the pending comment. Octarine uses the verified name and profile image from your account as the public attribution. Your email address and sign-in provider are not shown to other readers.

Read And Reply

Click a highlighted passage or the comments button at the top of the page to open the conversation. Readers do not need to sign in to read visible threads.

A thread contains one anchored comment and a flat list of replies. Only the reader who started the thread and the note creator can reply. Other readers can follow the conversation but cannot join it.

The reader who started a thread can delete it, including all of its replies. A participant can also delete a reply they posted.

Updating a published note does not copy comments into the Markdown file. Octarine tries to reconnect open threads to the same passage after an update. When the passage has changed too much, the thread keeps its saved quote and shows that the commented passage has changed instead of highlighting the wrong text.

Review Comments On Your Note

When a reader starts a thread or replies, Octarine emails the note creator. Open Review comment in the email to go directly to that conversation with temporary, note-specific review access.

You can also sign in on the shared page with a Google or GitHub account whose verified email matches the email attached to your Octarine license. Open the Comments panel to see the owner controls.

As the note creator, you can:

• Reply to an open thread.
• Resolve or reopen a thread.
• Hide or show a thread or individual reply.
• Turn new comments and replies on or off for that note.

Resolving removes a thread's inline highlight but keeps the conversation in the Comments panel. Hiding removes the thread or reply from the public view. Turning comments off prevents new comments and replies; it does not delete existing conversations.

Privacy And Limits

Comments are part of the public shared page. Do not include private information that should not be visible to anyone with the note link.

Octarine keeps the verified name, email address, provider identity, and profile image needed for attribution, account linking, and abuse prevention. Public comment responses expose only the display name and a secure profile image URL. A comment notification sent to the note creator can include the commenter's verified email address.

A comment or reply can contain up to 4,000 characters, and the selected passage can contain up to 2,000 characters. A note can have up to 200 open threads, with up to 50 replies in each thread.

Unpublishing or expiring a shared note makes its page and comments unavailable. Deleting the local Markdown file alone does not unpublish the hosted copy.

Quick Answers