Formatting & mentions
Make messages clearer with bold, italic, lists of formatting, links, inline code and code blocks — and pull someone in with an @mention that notifies them.
Basic formatting, Advanced mentions. Plain text is fine, but a little formatting makes coaching instructions far easier to follow — emphasise the important set, link the form, mention the person who needs to act.
Formatting your message
The web composer is what-you-see-is-what-you-get: apply formatting and the text changes right there as you type, exactly how it will send. Use the formatting toolbar above the composer (bold, italic, strikethrough, inline code, code block, link) — or the keyboard shortcuts. The toolbar buttons highlight to show what’s active where your cursor is.
| Format | How | Looks like |
|---|---|---|
| Bold | toolbar B or ⌘/Ctrl + B | do this first |
| Italic | toolbar i or ⌘/Ctrl + I | gently |
| toolbar | ||
| Link | select text → link button → type a URL | the form |
Inline code |
toolbar | 3×5 @ RPE8 |
| Code block | toolbar | a fenced multi-line block |
Links are safe by default. A link with no scheme becomes
https://, and onlyhttp/httpslinks are ever made clickable — pasted or typedjavascript:/data:links are never linkified.
Here’s the same coaching message plain, then formatted — note how much faster the second one is to scan:
• Back squat
3×5 @ RPE8• Don't skip the warm-up
Log it when you're done 💪
Graceful by design: formatting is stored alongside the text as ranges, not baked into it. A client on an older app, or anywhere rich text can’t render, still sees the full message as clean plain text — nothing is ever lost or shown as stray symbols.
@Mentions
Type @ and start a name to pull up the people in the conversation. Pick one and it’s inserted as a mention — a highlighted reference that notifies that specific person, even in a busy group. Use the ↑/↓ keys and Enter to choose from the list.
A mention always stays readable on both sides of the conversation — it picks up an accent colour on incoming messages, and an underline on your own sent (green) messages so it never disappears into the bubble:
Who gets notified? Only the people you actually mention get the extra “you were mentioned” nudge. Everyone in the conversation still receives the normal new-message notification — see Notifications.
On mobile
Clients read all of this formatting and mentions in full in the mobile app. For now they compose in plain text — so a client’s replies come through as plain text, while everything you send from the web composer renders richly for them. See Messaging on mobile.
Next: changed your mind about a message? Editing & deleting →