Jira and Confluence wiki markup to Markdown converter
Paste Jira or Confluence wiki markup and get Markdown back, or switch direction and turn Markdown into Jira markup. Headings, bold, lists, tables, code blocks, quotes and links are all converted.
Everything runs in your browser. Your text and files stay on your device and are never uploaded.
How to use it
- Choose Jira to Markdown or Markdown to Jira.
- Paste your text into the left box, or open a .txt or .md file. Load example shows a sample of each.
- Read the converted text on the right. Notes under the boxes list anything that has no equivalent, such as text colours.
- Copy the result or download it as a file.
- Press Use result as input to convert it back and check that nothing was lost.
Jira wiki markup and Markdown side by side
| Element | Jira / Confluence wiki | Markdown |
|---|---|---|
| Heading | h2. Title | ## Title |
| Bold | *text* | **text** |
| Italic | _text_ | *text* |
| Strikethrough | -text- | ~~text~~ |
| Inline code | {{text}} | `text` |
| Link | [label|https://x.com] | [label](https://x.com) |
| Bullet list | * item, ** nested | - item, indented - nested |
| Numbered list | # item | 1. item |
| Code block | {code:java}...{code} | Fenced with three backticks |
| Table header | ||A||B|| | | A | B | plus a --- row |
| Quote | bq. text | > text |
Questions
How do I convert Jira markup to Markdown?
Pick Jira to Markdown, paste the description or comment source, and copy the result. h2. becomes ##, *bold* becomes **bold**, and {code} blocks become fenced code.
Why does my Jira text use *bold* and h1. instead of Markdown?
Jira and Confluence wiki markup is an older syntax that Atlassian kept for descriptions and comments. It differs from Markdown, which is why pasted README text looks wrong in Jira.
Which parts of Jira markup have no Markdown equivalent?
Text colours, anchors and macros such as {toc} have none. The tool removes colours and anchors, converts panels to block quotes and leaves other macros as written, then lists each case in the notes.
Does it handle nested and mixed lists?
Yes. Jira's ** and *# prefixes become indented Markdown lists, with bullet and numbered levels mixed correctly, and the reverse works too.
Which code languages does Jira support?
Jira's code macro knows languages such as java, javascript, python, bash, sql and yaml. Markdown fences with other languages, such as kotlin, convert to a plain code block, and TypeScript is tagged javascript.
Is my text uploaded anywhere?
No. The conversion runs in your browser, and a file you open is read on your device only.