Using markdown is an optional feature for advanced text fields.
If you enable its interpretation in the field configuration, you can use markdown in the text to add linebreaks, lists, tables and text formatting like bolding. It is incompatible with Conditonal color formatting.
How to activate markdown interpretation
-
Open the Field overview and select the formula field you want to edit, or create a new formula field.
-
Go to the Configure step.
-
Find the Display as section below the formula editor.
-
Toogle Interpret markdown in field results.
-
Use the preview area to verify the result.
-
Save the field configuration.
Supported markdown options
Line breaks
Line breaks can be interpreted.
There is a line break
between these two lines.
Headers
To create headers, place a specific number of hashes before the text. The hash count determines the header level.
# This is an H1
## This is an H2
###### This is an H6
Alternatively, add a line of equal signs under the text to create an H1 header, or a line of hyphens under the text to create an H2 header.
This is also an H1
==================
This is also an H2
------------------
Italic characters, bold characters and strikethrough text
Place a single asterisk or underscore before and after text to italicize it, and use two of them for bold text.
*Italic characters*
_Italic characters_
**bold characters**
__bold characters__
Add two tildes before and after a text excerpt to convert it to strikethrough text.
~~strikethrough text~~
Lists
You can create bulleted and numbered lists and combine them. Each list item must start with an asterisk for bulleted lists or with its position number and a dot for numbered lists, and must follow a line break.
If you add indentation before an item, the element becomes part of a sublist of the previous item.
Bulleted
* Item 1
* Item 2
* Item 3
* Item 3a
* Item 3b
* Item 3c
Numbered
1. Step 1
2. Step 2
3. Step 3
1. Step 3.1
2. Step 3.2
3. Step 3.3
Numbered and bulleted
1. Step 1
2. Step 2
3. Step 3
* Item 3a
* Item 3b
* Item 3c
Quotes
Precede every line of a quote with a greater-than sign for it to be recognized as a quote.
Introducing my quote:
> Neque porro quisquam est qui
> dolorem ipsum quia dolor sit amet,
> consectetur, adipisci velit...
Code
Wrap text with backticks to mark it as code. Double the backticks when the text itself contains backticks.
Use the backtick to refer to a `function()`.
There is a literal ``backtick (`)`` here.
If text has three backticks on the previous line and three backticks on the next line, it becomes a code block.
```
This is a code block
```
Links
Form links by placing the link text in brackets followed by the URL in parentheses.
This is [an example](http://www.atlassian.com/) inline link.
Links that redirect outside your Atlassian environment require user confirmation before opening the external site.
Tables
Create tables by placing a vertical bar before and after each cell and using line breaks to separate rows.
A row with hyphens and vertical bars (for example, | --------|---------|-------|) is required because it defines the table header.
| Day | Meal | Price |
| --------|---------|-------|
| Monday | pasta | $6 |
| Tuesday | chicken | $8 |
Bars
Type three or more hyphens on a new line to create a horizontal bar.
a
---
bar