Markdown to Jira Wiki Markup

Convert standard Markdown to Jira wiki markup for issue descriptions, comments, and wiki pages. Free, no signup — paste into Jira's text-mode editor instantly.

Markdown to Jira Wiki Markup

Jira's wiki markup format lets you write formatted content in issue descriptions, comments, and wiki pages using a lightweight text-based syntax. This tool converts standard Markdown to Jira wiki notation instantly — paste the output into Jira's text-mode editor and the formatting carries over.

How to paste into Jira

Where wiki markup is supported depends on your Jira version:

  • Jira Data Center / Server: All text fields (issue descriptions, comments) support wiki markup in the default editor. Look for a Wiki Markup or Text tab at the bottom of the editor, paste the output, then switch back to visual mode if you prefer.
  • Jira Cloud — classic (company-managed) projects: Look for the Switch to old editor link or a Text toggle at the bottom of the editor. Paste the wiki markup there.
  • Jira Cloud — next-gen / team-managed projects: The new WYSIWYG editor does not accept wiki markup directly. For heavily formatted content, use the Markdown → HTML tool and paste the HTML result instead.

Syntax comparison

MarkdownJira Wiki MarkupNotes
# Heading 1h1. Heading 1h1 through h6 supported
**bold***bold*Single asterisks for bold in Jira
*italic*_italic_Underscores for italic in Jira
~~strike~~-strike-Single hyphen wrapping
`inline code`{{inline code}}Double curly braces
``` code block ```{code:language=js} … {code}Language tag is preserved
[text](url)[text|url]Pipe separator between label and URL
![alt](url)!url|alt=text!External image; inline display
- item* itemNested items use **, ***
1. item# itemNested items use ##, ###
> blockquote{quote} … {quote}Block-level quote macro
Markdown table||header|| rowsDouble pipes for header cells
--- horizontal rule----Four hyphens in Jira

Jira-only macros

Jira wiki markup includes macros that have no Markdown equivalent. You can add these manually to the converted output:

  • {color:red}text{color} — coloured text (red, blue, green, etc.)
  • {panel:title=Note}content{panel} — bordered panel with an optional heading
  • {noformat}text{noformat} — preformatted plain text without syntax highlighting
  • {jira:KEY-123} — inline link to another Jira issue

What doesn't convert

  • Task lists — - [x] items become plain bullets; use Jira's native task list feature for interactive checkboxes
  • Footnotes — no equivalent in Jira wiki markup; use inline parenthetical notes instead
  • Raw HTML — stripped in most Jira contexts; use the HTML macro if you need raw HTML
  • Heading anchor links — Jira generates its own heading anchors; manual anchors are not needed

Jira vs Confluence wiki markup

Jira and Confluence use nearly identical wiki markup syntax — the same headings, bold, italic, code blocks, tables, and links. The main practical difference is where you paste the result: Confluence uses the Insert Wiki Markup dialog, while Jira uses the text-mode editor in issue descriptions and comments. If you need Confluence markup specifically, see Markdown to Confluence.

Related tools