markdown2jira

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.

Project Kickoff

This is a bold statement with italic and strikethrough text, plus some inline code.

Goals

  1. Ship the MVP
  2. Get user feedback
  3. 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.

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.