Markdown to Jira Converter
Convert Markdown to Jira Wiki Markup or a Jira CSV bulk-import file. Turn your headings and lists into Epics, Stories, Tasks and Sub-tasks — free, private and instant.
A fast md to Jira converter that handles headings, bold and italic text, links, tables, code blocks and nested lists — no signup and nothing ever leaves your browser.
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?
This tool converts Markdown to Jira (Markdown → Jira Wiki Markup and Markdown → Jira CSV). The syntax reference table below maps every element both ways, so you can also use it as a quick Jira-to-Markdown cheat sheet when editing by hand.
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.