MarkdownForge

Markdown to Jira converter

Write in Markdown, paste into Jira. Headings, lists, tables and code blocks are converted to Jira’s wiki markup.

Markdown to Jira cheat sheet

MarkdownJira
# Titleh1. Title
**bold***bold*
~~gone~~-gone-
`code`{{code}}
[text](url)[text|url]
- item / 1. item* item / # item
```py{code:py}
> quote{quote}…{quote}

Does Jira support Markdown?

Jira Cloud’s new editor understands a few Markdown shortcuts as you type (like ** and #), but pasted Markdown, the REST API (v2) and Jira Server/Data Center expect Atlassian wiki markup. Converting first means tables and code blocks render correctly wherever the text ends up, including automation rules and API-created issues.

Using the output

  • Jira Data Center / Server: paste into the Text mode of the description field.
  • Jira Cloud: paste into a field that uses the wiki renderer, or send it via the v2 REST API description field.
  • Automation and scripts: use the output as a template string.

Other formats

Markdown converts to: Confluence, Slack, LaTeX, BBCode, MediaWiki, AsciiDoc, reStructuredText, plus HTML, PDF, Word and Excel.

Questions people ask

How do I make a table in Jira?
Header cells use double pipes: ||Name||Status||, body rows single pipes: |API|Done|. Paste a Markdown table here to get that automatically.
How do I add a code block in Jira?
Wrap it in {code:language} … {code}. A Markdown ```lang fence is converted to exactly that.
Why is bold a single asterisk in Jira?
Jira markup uses *bold* and _italic_, while Markdown uses **bold** and *italic*. Pasting Markdown unconverted makes bold appear as italic or literal asterisks.

Related tools

MF-05Markdown to HTMLClean HTML fragment or a full styled pageMF-08Markdown to rich textCopy formatted text for Docs, Gmail, WordMF-01Markdown editorSplit-pane editor with live preview, autosave and exportsMF-09Table generatorEdit a grid, set alignment, copy the table