---
tags: tutorials
disqus: hackmd
---

{%hackmd KghC_AJ7Rui37eDW5PVl9Q %}

# Use comments to collaborate asynchronously
{%hackmd @docs/base-theme %}

You can contribute to the note using Comments <i class="fa fa-commenting-o"></i>.

While HackMD does best in real-time collaboration, some contributions happen asynchronously. Sometimes you want to discuss about the note content without changing it and sometimes you don't think the discussion is relevant for the community to know. Comments are best for these use cases.

## Write comment
Select the text you want to comment on and hit the **<i class="fa fa-commenting"></i> Comment** button that pops up. Leave the comment on the right-hand side comment area and hit <kbd>Enter</kbd> or <kbd>Return</kbd>.

**▲ Select the text you want and leave a comment**

:::info
:bulb: **Hint:** You need to sign-in to leave a comment.
:::

Edit or delete your own comments from the <i class="fa fa-fw fa-ellipsis-v"></i> menu at the top right corner of the comment.

**▲ Edit or delete your comment**

## View comment
Comments are attached to the text commented and the text background is highlighted. The comments are toggled off by default. Click the **<i class="fa fa-commenting"></i> # comment(s)** button at the top right corner to show all comment threads.

**▲ View comment thread**

Alternatively, you can click on the commented text or the <i class="fa fa-commenting-o"></i> icon at the end of the line to view the comment. Click anywhere else to toggle it off.

Text with multiple overlapping comments will have darker shades of color, different comment threads will be stacked at the end of the line.

:::spoiler Resolve and Hide a comment/thread are under redesign

## Resolve comment thread
When discussion in a comment thread concludes, the thread can be marked as resolved. This tells other collaborators that this discussion has reached conclusion and no longer demands attention. They can be re-opened again for follow-ups.

**▲ Resolve comment thread**

## Hide resolved comment thread
Resolved comments can be hidden, so the note looks cleaner.
Hidden comments can be found and shown again in the comment **Settings**.

**▲ Hide resolved comment thread**

:::

## Comment permission
The comment feature can be disabled entirely for a note in the <i class="fa fa-share-alt fa-18"></i> **Sharing** menu. All comment threads will be invisible and no new comment can be added. Enabling commenting again to bring back all the comment threads.


A note admin can decide what roles are needed for a user to leave a comment. Manage the comment permission in the <i class="fa fa-share-alt fa-18"></i> **Sharing** menu.

###### tags: `tutorial`