Using special formatting

A variety of special formatting can be applied to text entered in a checklist item.

Basic Markdown

HTML cannot be inserted directly, as this poses a potential security risk. Instead, you can use the following basic Markdown syntax to format your text.

Formatting

Syntax

Example

Formatting

Syntax

Example

Italics

The customer said *what*?

The customer said what?

Bold

Invoices **must** be submitted by 5.

Invoices must be submitted by 5.

Hyperlinks

See our [return policy](http://www.company.com/return-policy).

See our return policy.

Advanced Markdown

This feature requires that the Advanced Markdown setting be enabled.

You can use almost the full Markdown suite (CommonMark specification) to customize your checklists to your heart’s desire. The only exception is that you cannot insert HTML blocks, as this poses a security risk.

To get you started, here are a few examples of what you can do:

Formatting

Syntax

Example

Formatting

Syntax

Example

Heading 1

# Heading

Heading 2

## Heading

Heading 3

### Heading

Heading 4

#### Heading

Heading 5

##### Heading

Bulleted list

* List

Numbered list

1. List

Block quote

> Block quote

Code block

code block
(4 spaces)

Images

This feature requires that the External Images setting be enabled.

You can embed external images into checklist items using Markdown syntax.

Formatting

Syntax

Example

Formatting

Syntax

Example

External image

![alt-text](http://www.okapya.com/logo.png)

Dates

When dates are entered in DD/MM/YYYY or MM/DD/YYYY format, special formatting is automatically applied.

Emojis

The following emojis can be inserted:

Emoji

Code

Emoji

Code

:-)

:-D

;-)

:-(

:-S

$-)

8O

8-)

(!)

(?)

(i)

(off)

(on)

(y)

(n)

(*) (*r) (*g) (*b)

Any issue keys that follow Jira standards will automatically be converted to hyperlinks.

User mentions

An @ symbol that is immediately followed by characters will automatically have special formatting applied.

This is not a true @mention function and is only a visual indicator. A list of users is not suggested as you type, and users are not notified that their name has been used.


SERVER documentation (On Cloud? Go here.)
Have questions? Contact our Service Desk for help anytime.