---
title: "Collaboration"
description: "Comment on any part of a page, suggest edits, get the right people's attention, and keep Jira issues next to the work they're about."
canonical_url: https://docs.markdrop.in/collaboration/overview
last_updated: 2026-11-09
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Collaboration

Pages and Markdown documents are where your team discusses the work, not just where it's written. Comment on a sentence, a block or the whole page, suggest the exact words, bring in the people who need to answer, and keep the Jira issues next to the text they're about. The page's text never changes until someone who can edit it says yes.

![A launch plan page with highlighted passages and the comments panel beside it: a page-level comment from Riya, and a thread on "once QA signs off on the payment flows" where Alex mentions Riya, Riya answers and mentions Sam, and Sam confirms. A Jira chip and a Jira card sit in the page.](https://docs.markdrop.in/docs-assets/collaboration/overview/hero.webp)

## What you can do

**[Comments](https://docs.markdrop.in/collaboration/comments)**

Comment on selected text, a block or the page. Reply, @mention, react and resolve, live for everyone who has the page open.

**[Suggested edits and AI help](https://docs.markdrop.in/collaboration/suggested-edits)**

Propose the exact words; an editor accepts in one click. Apply with AI, Summarize, @AI in a thread and a tone check.

**[Notifications](https://docs.markdrop.in/collaboration/notifications)**

The bell, calm email (instant mentions, batched replies), Slack messages with Reply and Resolve, and a daily digest.

**[Assign, Home and sign-off](https://docs.markdrop.in/collaboration/assign-and-sign-off)**

Turn a thread into someone's task, see what's waiting on you on Home, and sign off knowing what's still open.

**[Jira in pages](https://docs.markdrop.in/collaboration/jira-in-pages)**

Live chips, cards and lists. Change status and assignee from the page, and turn a thread into an issue.

**[Insights and exports](https://docs.markdrop.in/collaboration/insights-and-exports)**

How a discussion is going: first reply, time to resolve, most-discussed sections. Export pages with their comments.

**[Settings and privacy](https://docs.markdrop.in/collaboration/settings-and-privacy)**

Who sees and writes comments, showing them publicly, and turning them off for an item or a workspace.

**[For AI apps](https://docs.markdrop.in/collaboration/for-ai-apps)**

Let Claude, ChatGPT or Cursor read threads, reply, suggest edits, file Jira issues and tell you what's waiting on you.

## How it fits together

1. **Someone comments.** Select a few words and choose **Comment**, or press **⌘⌥M**. The passage is highlighted for everyone who can see comments. See [Comments](https://docs.markdrop.in/collaboration/comments).
2. **The right people hear about it.** @mention someone or assign the thread and they're told under the bell, by email, on their phone or in Slack. See [Notifications](https://docs.markdrop.in/collaboration/notifications).
3. **The discussion reaches a decision.** Suggest the words, or let AI draft them from the thread, and an editor accepts them into the page as a new version. See [Suggested edits and AI help](https://docs.markdrop.in/collaboration/suggested-edits).
4. **Work that's bigger than a comment goes to Jira.** Create an issue from the thread; it links back, and resolving one offers to close the other. See [Jira in pages](https://docs.markdrop.in/collaboration/jira-in-pages).
5. **Nothing falls through.** Home lists the threads waiting on you, and a sign-off says when threads are still open. See [Assign, Home and sign-off](https://docs.markdrop.in/collaboration/assign-and-sign-off).

## Where it works

| Item | Comments | Jira chips, cards and lists |
| --- | --- | --- |
| Pages | Yes | Yes |
| Markdown documents with an owner | Yes | Chips and links |
| Files (PDFs, slides, sheets, video, HTML) | Not yet | No |
| End-to-end encrypted documents | Never (Markdrop can't read them) | No |
| Documents published without an account | No | No |

Commenting is for people who are signed in and can open the item. Readers who aren't signed in see a clean page, unless the owner chose to [show comments publicly](https://docs.markdrop.in/collaboration/settings-and-privacy#show-comments-publicly).
