Markdown to Jira

Convert Markdown into Jira wiki markup for tickets and comments.

Convert Markdown to Jira wiki markup instantly — headings, bold, italic, code blocks, lists, links and quotes. Paste GitHub-style Markdown and get text ready for Jira. Runs entirely in your browser, nothing is uploaded. It runs free in your browser on Gera Tools, with nothing uploaded.

Last updated Source: Gera Tools

Which Markdown features are converted?

Headings, bold, italic, inline code, fenced code blocks, ordered and unordered lists (with nesting), links, blockquotes, strikethrough and horizontal rules are all mapped to their Jira wiki markup equivalents.

Jira’s classic editor uses its own wiki markup, not Markdown — so pasting a README or pull-request description straight into a ticket leaves you with broken # headings and literal **stars**. This converter rewrites GitHub-style Markdown into the matching Jira syntax so it renders correctly in ticket descriptions and comments. Paste on the left, copy clean Jira markup from the right.

How it works

The text is processed line by line. Fenced code blocks (```) are detected first and their contents passed through untouched, becoming {code} (or {code:js} when a language is given). Outside code, each line is matched against block rules — headings, blockquotes, lists, horizontal rules — and the remaining inline syntax is rewritten in a fixed order (links, then code spans, then bold, then italic, then strikethrough) so the shared * and _ characters don’t collide.

Syntax conversion table

MarkdownJira wiki markup
# Headingh1. (## → h2, etc.)
**bold***bold*
*italic*_italic_
~~strike~~-strike-
`code`{{code}}
```js block{code:js}{code}
[text](url)[text|url]
> quotebq. quote
- item (top level)*
- item (1 indent)**
1. item (ordered)#
-------

Worked example

Input Markdown:

## Setup guide

Follow these **steps** to get started:

1. Clone the repo
2. Install deps
   - Run `npm install`
   - Or use `yarn`

> See the [docs](https://example.com) for details.

Jira wiki markup output:

h2. Setup guide

Follow these *steps* to get started:

# Clone the repo
# Install deps
## Run {{npm install}}
## Or use {{yarn}}

bq. See the [docs|https://example.com] for details.

When classic Jira markup still applies

This converter targets the Jira classic (wiki markup) editor, which is the text view available by clicking the wiki markup button in the description or comment field. The newer Jira rich-text (WYSIWYG) editor does not use wiki markup and renders some Markdown natively when pasted — but inconsistently. If your ticket shows the raw markup symbols instead of rendered formatting, you are in the classic editor and this conversion is what you need.

Confluence uses a related but not identical wiki markup. This converter targets Jira; always spot-check Confluence output since some syntax differs (especially tables and colons in headings).

Everything happens in your browser — nothing is uploaded.