Jira Wiki Markup Cheat Sheet
A complete reference for converting Markdown to Jira Wiki Markup. Every element below maps both ways, so it doubles as a Jira-to-Markdown lookup. Need it done automatically? Use the free converter →
Markdown ↔ Jira Wiki Markup syntax
| Element | Markdown | Jira Wiki Markup |
|---|---|---|
| Heading 1 | # Heading | h1. Heading |
| Heading 2–6 | ## … ###### | h2. … h6. |
| Bold | **bold** | *bold* |
| Italic | _italic_ or *italic* | _italic_ |
| Bold + italic | ***text*** | *_text_* |
| Strikethrough | ~~text~~ | -text- |
| Inline code | `code` | {{code}} |
| Code block | ```js code ``` | {code:js} code {code} |
| Blockquote (single line) | > quote | bq. quote |
| Blockquote (multi-line) | > line 1 > line 2 | {quote} line 1 line 2 {quote} |
| Link | [text](https://url) | [text|https://url] |
| Bare URL | <https://url> | [https://url] |
| Image |  | !https://img.png! |
| Bullet list | - item | * item |
| Nested bullet | - item | ** item |
| Numbered list | 1. item | # item |
| Task done | - [x] done | * (/) done |
| Task open | - [ ] todo | * (x) todo |
| Horizontal rule | --- | ---- |
| Table header | | a | b | | - | - | | ||a||b|| |
| Table row | | 1 | 2 | | |1|2| |
Example: Markdown table to Jira table
Markdown
| Feature | Status |
| --- | --- |
| Login | Done |
| Search | WIP |Jira Wiki Markup
||Feature||Status||
|Login|Done|
|Search|WIP|Frequently asked questions
What is Jira Wiki Markup?
Jira Wiki Markup is the lightweight text-formatting syntax used in Jira description and comment fields — for example h1. for headings, *bold*, {{monospace}} and {code} blocks. It is similar in spirit to Markdown but uses a different syntax.
How do I convert a Markdown table to a Jira table?
Header cells are wrapped in double pipes (||Header||) and body cells in single pipes (|cell|). Paste your Markdown table into the converter and it produces this format automatically.
Can I convert Jira Wiki Markup back to Markdown?
This cheat sheet is bidirectional — every row shows both the Markdown and the equivalent Jira Wiki Markup, so you can translate in either direction by hand. The automated converter goes Markdown → Jira.
Don't convert by hand
Paste your Markdown and get Jira Wiki Markup or a CSV bulk-import file instantly.
Open the Markdown to Jira converter