Formatting text
Where formatting works
Every place where you write a block of text takes the same formatting: a comment, a work item's or a project's Description, a customer's Notes, and a public form's Introduction, Footer and Thank-you message. The text is stored as you typed it, with its marks, and shown formatted wherever it is read in full. Where only one line fits — a project card, a grid cell, a tooltip, a notification title — the words are shown without their formatting.
The toolbar
Under the field, the toolbar holds the inline styles: Bold (Ctrl+B), Italic (Ctrl+I),
Strikethrough, Inline code and Insert link. Select some text and click one, and the marks
wrap the selection; with nothing selected, the marks are inserted and you type between them.
Insert link writes [text](url) with the parts selected for you to replace.
The Block style button beside them opens the same list the slash menu shows, for the line the cursor is on.
A description or a form text has a Preview; a comment has none: it shows formatted the moment it is sent.
The slash menu
Type / at the start of a line, or after a space, and a menu lists the block styles:
| Style | What it does |
|---|---|
| Text | A plain paragraph: removes the line's current style. |
| Heading 1, Heading 2, Heading 3 | A section heading, largest to smallest. |
| Bulleted list | A list with bullets. |
| Numbered list | A list with numbers. Press Enter at the end of an item and the next number is written for you. |
| To-do list | A list with checkboxes. The boxes show the state you typed ([ ] open, [x] done); they cannot be ticked in the reading view. |
| Quote | A quoted passage, set off with a bar. |
| Code | A block of code, shown exactly as typed. |
| Divider | A horizontal line between sections. |
Keep typing after the / to filter the list by name; Up and Down move the highlight;
Enter, Tab or a click applies the style to the current line, replacing the one it had (a
bulleted line turns into a heading, say). Escape closes the menu, and so does a word that matches
no style, so and/or, km/h and a web address never open it.
Pressing Enter at the end of a list item continues the list; Enter on an empty item ends it. In a comment, Enter sends and Shift+Enter breaks the line; in a description, Enter breaks the line.
Mentions and links to items
Type @ and pick a person to mention them: they get a notification, and their name shows as a chip. Type # and pick a work item to link it: its number shows as a chip that opens the item. Both work in comments, descriptions and notes. They are not available in a public form's texts, which visitors read without an account.
Typing the marks yourself
The slash menu and the toolbar write ordinary Markdown, so you can also type the marks:
| You type | You get |
|---|---|
**bold** |
bold |
*italic* |
italic |
~~struck~~ |
|
`code` |
code |
[label](https://example.com) |
a link; only web and mail addresses become links |
# Heading at the start of a line |
a heading (## and ### for smaller ones) |
- item or 1. item |
a list item |
- [ ] task or - [x] task |
a to-do item |
> words |
a quote |
``` on a line of its own, before and after |
a code block |
--- on a line of its own |
a divider |
Pictures, tables and HTML are not part of the set: they show as the text you typed.
What stays plain
The emails the app sends — to the sender of a public form's request, for example — carry the words only. The same goes for the project list, the cards, the tooltips and the notification bell: a bold word in a description is an ordinary word there.