Format a task's description
A long description is easier for a runner and your team to follow when it has some shape: a heading per part, the steps as a list, what done means as a checklist, and error messages or commands as code. The description box formats as you write, and the runner reads the headings, lists and code as you laid them out.
Who can do this: anyone who can create tasks in the project, or edit the task.
-
On the task board, select New task. To format an existing task, open it and stay on its Task tab.
-
Find the formatting bar above the description box. Beside the board it shows Bold, Italic, H2, โข List, โ Checklist, ๐ Link and โฏ.
-
Select โฏ (More formatting) for the rest: H1, 1. List, โ (quote), Code, { } (code block) and ๐ผ Image. Select โฏ again to fold them away.

-
Select the words to format, then pick a button. A button with nothing selected formats what you type next, or the line the cursor is on for a heading, list, quote or code block. Pick the same button again to take the formatting off.
-
To add a link, select the words, then ๐ Link. Your browser asks for the Link URL: type or paste the address and confirm. To remove a link, select it, choose ๐ Link and clear the address. A web address you type or paste becomes a link on its own.
-
Put error messages, file contents and commands in a code block with { }, so they reach the runner exactly as written and spelling checks leave them alone.
-
Select Save to keep the draft, or Go to save and start it.
Shortcuts while you typeโ
You can format without the bar:
| Type | To get |
|---|---|
#, ## and a space at the start of a line | A heading (H1, H2) |
- and a space | A bulleted list |
1. and a space | A numbered list |
[ ] and a space | A checklist item |
> and a space | A quote |
| Three backticks | A code block |
| Ctrl+B or Ctrl+I (โ+B or โ+I on a Mac) | Bold or italic |
Text you paste that's already written in Markdown, such as a spec from your notes app or a code host, keeps its headings, lists, links and code. HTML tags you paste as text show as plain text.
Relatedโ
- Write a good task description: what to put in the description.
- Put an image in a task's description: pictures with ๐ผ Image.
- Fix spelling as you write a task: catch misspelled words as you type.
- Format a comment and attach files: the same bar in a comment.