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
| Markdown | Jira wiki markup |
|---|---|
# Heading | h1. (## → h2, etc.) |
**bold** | *bold* |
*italic* | _italic_ |
~~strike~~ | -strike- |
`code` | {{code}} |
```js block | {code:js} … {code} |
[text](url) | [text|url] |
> quote | bq. 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.