Mentions and dates
Type @ to mention a person or a team, or to insert a date that reads well and is easy to change. Mentions notify
people who can open the document; inserting a date doesn’t notify anyone. The file stays ordinary markdown.
Mention someone
Section titled “Mention someone”Type @ at the start of a word and keep typing a name. The list has three sections:
- People: everyone who can open this document.
- Teams: the workspace’s teams.
- Dates: see below.
Press Enter or Tab to pick, or click a name. Escape closes the list and leaves what you typed as plain text. The list works in Live, Source and Split, but not inside code. It stays on even when you turn off Slash menu and emoji in Editor settings.
Mention a date
Section titled “Mention a date”The Dates section offers Today, Tomorrow and Yesterday. Type a day’s name, such as @fri, for one of
the next seven days. You can also type a date, such as @oct 30 or @2026-11-03, or choose Pick a date… to
pick one from a calendar.
However you choose it, the date goes into the document as plain text, such as 2026-10-30.
How mentions look
Section titled “How mentions look”In Live view and the Split preview, a mention shows as a chip with the person’s or team’s current name. If someone changes their name, the chip shows the new one straight away. The words in the file stay as you wrote them.
A date shows as a chip such as Thu, Oct 30, with the year only when it isn’t this year. Hover it to see how far
away it is, such as “in 8 days”. Any date written as 2026-10-30 on its own shows this way, however it was typed.
When your cursor is on a chip, Live view shows the markdown underneath, so you can edit it like any other text.
Open a mention or change a date
Section titled “Open a mention or change a date”- A person or a team: in Live view, hold Ctrl (Cmd on a Mac) and click the chip. In the Split preview, a plain click is enough. A person opens their profile page; a team opens its team page, with its name and members.
- A date: click the chip to open the calendar and choose another day.
Who is told
Section titled “Who is told”About a minute after you stop typing, each person you newly mentioned gets a notification in the bell, such as Ada mentioned you in “Launch plan”, with the paragraph around the mention. Opening it takes them to the heading above the mention. Mentioning a team tells each of its members.
Because Colletta waits until you stop typing, you have a moment to fix a slip: if you delete a mention or swap the name straight away, the first person is never told.
- Only people who can open the document are told, and never the person who wrote the mention.
- Each person hears once per document and author, however many times you mention them.
- Removing a mention sends nothing.
- Mentions copied in by Duplicate or from a workspace template don’t tell anyone.
Notifications appear in the app only. Email notifications aren’t available.
Mention someone who can’t open the document
Section titled “Mention someone who can’t open the document”If you can share the document, the list also shows workspace members who can’t open this document, under Cannot open this document. Choosing one asks Share this document?
- Share gives them Can view, through the usual sharing rules, and they’re told about the mention.
- Not now keeps the mention without sharing. They aren’t told, because they couldn’t open the document anyway.
Otherwise, the list only offers people who can already open the document.
In the file
Section titled “In the file”A mention is an ordinary markdown link:
[@Ada Lovelace](/w/acme/people/0f3c...)[@Design](/w/acme/teams/7a21...)A date is plain text, such as 2026-10-30. Nothing special is stored, so a downloaded or copied document is normal
markdown. In other tools a mention reads as “@Ada Lovelace”, with a link that only works inside Colletta. See
The markdown Colletta writes.