Collaboration

3 min readUpdated Nov 9, 2026

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.

What you can do

#

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

Where it works

#
ItemCommentsJira chips, cards and lists
PagesYesYes
Markdown documents with an ownerYesChips and links
Files (PDFs, slides, sheets, video, HTML)Not yetNo
End-to-end encrypted documentsNever (Markdrop can't read them)No
Documents published without an accountNoNo

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.

Did this page help?