Markdown to Jira & Jira to Markdown Converter
Free online converter: transform Markdown into Jira Wiki Markup, convert Jira markup back to Markdown, or create a Jira CSV bulk-import file. Instant, private, and runs 100% in your browser.
A fast md to Jira and jira to markdown tool supporting headings, tables, code blocks, links, task lists and Epics/Stories — compatible with Jira Cloud and Jira Data Center with zero signup.
Project Kickoff
This is a bold statement with italic and strikethrough text,
plus some inline code.
Goals
- Ship the MVP
- Get user feedback
- Iterate quickly
Notes
Remember to keep scope small. Quality over quantity.
function hello() {
console.log("Hello Jira");
}
| Feature | Status |
|---|---|
| Login | Done |
| Export | WIP |
- Set up repo
- Write tests
See the docs for details.
How to convert Markdown to Jira
- 1
Paste your Markdown
Paste or type your Markdown — headings, lists, tables, code blocks and links — into the input panel.
- 2
Pick an output format
Choose Jira Wiki Markup to paste into a description or comment, or Jira CSV to bulk-create issues.
- 3
Copy or download the result
Copy the converted Jira Wiki Markup, or download the CSV file ready for Jira's issue importer.
- 4
Import into Jira
Paste the markup into Jira, or import the CSV via Settings → System → External System Import → CSV and map the columns.
Markdown ↔ Jira Wiki Markup syntax
| Element | Markdown | Jira Wiki Markup |
|---|---|---|
| Heading | # H1 | h1. H1 |
| Bold | **bold** | *bold* |
| Italic | _italic_ | _italic_ |
| Strikethrough | ~~text~~ | -text- |
| Inline code | `code` | {{code}} |
| Code block | ```js … ``` | {code:js} … {code} |
| Link | [text](url) | [text|url] |
| Bullet list | - item | * item |
| Numbered list | 1. item | # item |
| Quote | > quote | bq. quote |
| Table header | | a | b | | ||a||b|| |
Frequently asked questions
What is the difference between Jira Wiki Markup and Jira CSV import?
Jira Wiki Markup is the text formatting syntax (h1., *bold*, {code}) you paste into a description or comment field. A Jira CSV import file is used to bulk-create issues — each row becomes an Epic, Story, Task or Sub-task. This tool does both.
Is this tool free and does it send my data anywhere?
Yes, it is completely free. All conversion happens locally in your browser — your Markdown never leaves your device, and there is no signup.
How do I import the generated CSV into Jira?
Download the CSV, then in Jira go to Settings → System → External System Import → CSV (or the project-level Import issues from CSV). Upload the file, map the columns, and run the import.
How are Epics, Stories and Sub-tasks detected?
By default H1 becomes an Epic, H2 a Story, H3 a Task, top-level bullets become Tasks and nested bullets become Sub-tasks. You can change this mapping in the CSV tab.
Can I convert Jira Wiki Markup back to Markdown?
Yes! Click the 'Jira Wiki → Markdown' tab above. Paste any Jira issue description or comment with headings (h1.), bold (*text*), code blocks ({code}), tables or lists, and get clean, formatted Markdown instantly.
How do I convert a Markdown table to a Jira table?
Paste a standard Markdown table (| a | b | with a --- header row) and the converter outputs Jira Wiki Markup table syntax, using ||header|| for the header row and |cell| for body rows. It also converts Jira tables back to Markdown tables.
Is this compatible with both Jira Cloud and Jira Data Center / Server?
Yes. Jira Wiki Markup is supported across all versions of Jira (Cloud, Server, and Data Center). The generated markup and CSV import files work seamlessly on all editions.