# 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>.
:::info
:bulb: **Hint:** You need to sign-in to leave a comment.
:::
**▲ Select the text you want and 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.

## Pin right panel(comment panel)

We understand that sometimes in Split-view, viewing messages can obstruct the preview on the right side. Therefore, you can click the <i class="fa fa-thumb-tack" aria-hidden="true"></i> pin button next to the <i class="fa fa-times" aria-hidden="true"></i> to adjust the right message panel, so that the preview area and the message panel do not overlap.


## 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.