Formatting Guide
Learn how to format your checklist effectively – add due dates, mention users, structure content, and enhance readability!
Contents 👇🏻
Checklists items
You Type | You Get |
|---|---|
- item todo
+ item done
~ item in progress
x item cancelled |  |
☝🏼NOTE: There should NOT be any additional tabs or spaces at the beginning of the row. Otherwise, this block renders incorrectly 🙃
Mandatory items
You Type | You Get |
|---|---|
-! Item 1
~! Item 2
x! Item 3
+! Item 4
-! [PASSED] Item 5
-! [IN QA] Item 6 | |
☝🏼 NOTE: There should NOT be any additional tabs or spaces at the beginning of the row. Otherwise, this block renders incorrectly 🙃
Headers
You Type | You Get |
|---|---|
# Biggest heading
## Big heading
### Heading
#### Small heading
##### Smaller heading
###### Smallest heading
| |
☝🏼 NOTE: There should NOT be any additional tabs or spaces at the beginning of the row. Otherwise, this block renders incorrectly 🙃
📖 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
💡 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.
You type | You get |
|---|---|
# 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 | |
📖 Learn more about working with Checklist Tabs from -> Checklist Tabs
Text Formatting
You Type | You Get |
|---|---|
**bold text**
_italic text_
`emphasize`
| |
Item details
You Type | You Get |
|---|---|
- item todo
> piece of information
> that is useful for new ppl
> on how to complete an item
> even `with` **markdown** *support* | |
☝🏼 NOTE: There should NOT be any additional tabs or spaces at the beginning of the row. Otherwise, this block renders incorrectly 🙃
Manage item details:
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:
You Type | You Get |
|---|---|
- item todo
> * bullet point one
> * bullet point two
> > * bullet point nested
> 1. list item one
> 2. list item two | |
☝🏼 NOTE: There should NOT be any additional tabs or spaces at the beginning of the row. Otherwise, this block renders incorrectly 🙃
Dates
You Type | You Get |
|---|---|
- date in past 10-03-2022
- date in the future 10-12-2025
- today 21-06-2023 |
|
Smart Checklist also supports other date formats: 10-03-2025 10/03/2025 2025/10/03 2025-03-10
You can also easily access a calendar by typing “//”:
You Type | You Get |
|---|---|
// | |
Assignee
Coming soon!
User mentions
You Type | You Get |
|---|---|
*just start typing @ and user name | |
*you can mention multiple users as well | |
URL (external links)
You Type | You Get |
|---|---|
- http://google.com
- [link to google](http://google.com) | |
Links Jira Issues
You Type | You Get |
|---|---|
|
|
Emojis 😎
You Type | You Get |
|---|---|
: | |
Images
You Type | You Get |
|---|---|
- 
|
|
Display text in [ ]
You Type | You Get |
|---|---|
~ \[Text in brackets\] |
|
You are all set! Enjoy using Smart Checklist like a pro 😎