--- 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>. :::info :bulb: **Hint:** You need to sign-in to leave a comment. ::: ![leave a comment](https://hackmd.io/_uploads/Sy0fgFPQ0.gif)**▲ 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. ![](https://hackmd.io/_uploads/Bk6IlKPXR.png =400x)**▲ 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 all comment thread](https://hackmd.io/_uploads/BJvhmtwXR.gif)**▲ 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. ## 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. ![comment setting](https://hackmd.io/_uploads/ryQvEYPmA.gif) 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.