Formatting Guide & Markdown
Learn how to format your checklist effectively – add due dates, mention users, structure content, and enhance readability!
Text Formatting
Checklist UI | Markdown |
|---|---|
 | **bold text**
_italic text_
`emphasize`
|
Headers
Checklist UI | Markdown |
|---|---|
| # Biggest heading
## Big heading
### Heading
#### Small heading
##### Smaller heading
###### Smallest headi |
💡HINT: Learn more about working with Headers from -> Checklist Headers
Checklist Tabs
Both H1 headers (headers starting with # ) and checklist tabs use the same markdown syntax: # Header name / Tab name
Checklist UI | Markdown |
|---|---|
| # Code Quality
- Code is written and merged
- No critical bugs remain
- Unit tests are written and passing
# Testing
- Feature is covered by automated tests
- Integration tests are passed
- Acceptance criteria are validated
# Documentation
- User documentation is updated.
- Technical documentation is updated |
💡 HINT: If user works with checklist in Tab view, H1 headers (starting with #) are displayed as tabs, List view – all tabs appear as H1 headers in the checklist.
📖 Learn more about working with Checklist Tabs from -> Checklist Tabs
Statuses
Checklist UI | Markdown |
|---|---|
| - item todo
+ item done
~ item in progress
x item skipped
- [Failed] item in custom status |
Read more how to work statuses here → Checklist Statuses
Priority
Checklist UI | Markdown |
|---|---|
| - [priority="High"] checklist item with High priority
- [priority="Medium"] checklist item with Medium priority
- [priority="Low"] checklist item with Low priority |
Read more how to work with Checklist Priority, Assignee and Due Date here → Checklist Priority, Assignee, Due Date
Assignee
Checklist UI | Markdown |
|---|---|
| - [assignee="<userId>"] item with assigned user
- [assignee="<userId>"] item with assigned user
- [assignee="<userId>"] item with assigned user |
💡HINT: Read more how to work with Checklist Priority, Assignee and Due Date here → Checklist Priority, Assignee, Due Date
Due Date
Checklist UI | Markdown |
|---|---|
| - [dueDate="2026-06-07"] date in past
- [dueDate="2026-07-04"] date in the future
- [dueDate="2026-06-12"] today |
💡HINT: Read more how to work with Checklist Priority, Assignee and Due Date here → Checklist Priority, Assignee, Due Date
User Mentions
To add user mention just start typing @ and user name. You can mention multiple users.
Checklist UI | Markdown |
|---|---|
| - current user @<userID>
- another Jira user @<userID>
- custom user mention @DevTeam |
💡HINT: You can also Notify Mentioned Users by Email or JQL Search 🚀
Date Mentions
Smart Checklist supports the following date formats: DD-MM-YYYY, DD/MM/YYYY, YYYY/MM/DD, YYYY-DD-MM
You can also easily access a calendar by typing //:
Checklist UI | Markdown |
|---|---|
| - date in past 2026-06-07
- date in the future 2026-07-10
- today 2026-06-12 |
Mandatory items
Checklist UI | Markdown |
|---|---|
| -! Mandatory Item ToDo
~! Mandatory Item In Progress
x! Mandatory Item Skipped
+! Mandatory Item Done
-! [PASSED] Mandatory Item Custom Status |
💡HINT: Read more about Mandatory Items here → Mandatory Items
Item Details
Checklist UI | Markdown |
|---|---|
| - item todo
> piece of information
> that is useful for new ppl
> on how to complete an item
> even `with` **markdown** *support* |
Add details | |
add details by hovering the checklist item | add details via 3-dots menu |
Edit details | |
edit details by clicking on the pencil icon | edit details by clicking on them
|
Delete details | |
delete details by hovering the checklist item | delete details via 3-dots menu |
Bullet points and Lists
You can make your checklist item details as a list or add bullet points:
Checklist UI | Markdown |
|---|---|
| - item todo
> * bullet point one
> * bullet point two
> > * bullet point nested
> 1. list item one
> 2. list item two |
External links
Checklist UI | Markdown |
|---|---|
| - http://google.com
- [link to google](http://google.com |
Jira Issues Links
Checklist UI | Markdown |
|---|---|
| - https://jira.atlassian.net/browse/RVCH-32 |
Emojis 😎
Start typing : to access emojis:
Checklist UI | Markdown |
|---|---|
| - Emoji :heart:
- Emoji :grinning:
- Emoji :white_check_mark: |
Images
Checklist UI | Markdown |
|---|---|
| - 
|
Display text in [ ]
Markdown | Checklist UI |
|---|---|
~ \[Text in brackets\] |
|