Markdown → Confluence

Convert Markdown to Confluence wiki markup

Translate headings, code fences, links, images, blockquotes, lists, and GFM tables to Atlassian Confluence (and Jira) wiki markup — paste directly into a Confluence editor in wiki-markup mode. Runs in your browser.

Write in Markdown Markdown → BBCode AsciiDoc ↔ Markdown

Converting Markdown → Confluence wiki

Markdown input

Confluence wiki output

h1. API Reference

The API uses *REST* semantics and returns _JSON_.

h2. Authentication

Pass an {{Authorization}} header:

{code:language=bash}
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.example.com/v1/users
{code}

h2. Endpoints

||Method||Path||Description||
|GET|/users|List users|
|POST|/users|Create a user|
See [the docs|https://example.com/docs].

Covers headings, inline formatting, fenced code (with language), links, images, blockquotes, lists, HR, and GFM tables. Complex Markdown features (footnotes, task lists, Mermaid) require Confluence add-ons.

Why convert Markdown to Confluence?

Most engineering teams write in Markdown — READMEs, RFCs, design docs, release notes. But corporate knowledge often lives in Confluence. This converter bridges the two: write once in Markdown, publish to Confluence without retyping.

What gets converted

Markdown	Confluence wiki markup
`# Heading`	`h1. Heading`
`bold`	`bold`
`_italic_`	`_italic_`
`\`code``	`{{code}}`
```js block	`{code:language=js}`
`[text](url)`	`[text
`![alt](url)`	`!url!`
`> blockquote`	`bq. blockquote`
`- bullet`	`* bullet`
`1. ordered`	`# ordered`
`---` (HR)	`----`
GFM pipe table	`

Workflow tips

Paste into the Confluence editor in wiki-markup mode. Some Confluence editions have a + button → "Insert wiki markup".
Watch your table widths. Markdown tables often render too wide in Confluence; trim columns or use Confluence-native macros for complex tables.
For Mermaid diagrams, install the Mermaid Confluence add-on; this converter outputs the source for you to paste.

Companion tools

Markdown to BBCode — for forums.
AsciiDoc ↔ Markdown — for AsciiDoc-based stacks.
Markdown Editor — write Markdown with live preview.

Privacy & data

All conversion happens inside your browser. No content is uploaded.

Frequently asked questions

What is Confluence wiki markup?

Confluence's older 'wiki markup' format uses syntax like `h1.`, `*bold*`, `{code}` blocks, `[text|url]` links, and `||headers||` tables. Modern Confluence editors use a rich text editor but still accept wiki markup for bulk insertions and templates.

Does this output the new Confluence storage format (XML)?

No — this converter targets wiki markup which is universally supported. The XML storage format is more verbose and varies by Confluence version. Wiki markup converts cleanly inside any modern Confluence editor.

Which Markdown features are supported?

Headings (h1–h6), bold, italic, inline code, fenced code blocks (with language), links, images, blockquotes, unordered and ordered lists, horizontal rules, and GFM pipe tables. Footnotes, task lists, and Mermaid diagrams require Confluence add-ons.

Why not use Confluence's native Markdown import?

It exists but is inconsistent — some Confluence versions render Markdown inline, others require copy-paste into a specific macro. This tool gives you the wiki-markup output you can drop anywhere a Confluence editor accepts wiki text.

Will Jira accept the same output?

Yes — Jira's text fields use the same wiki markup as legacy Confluence. The output works in Jira issue descriptions, comments, and templates.

Is my content uploaded?

No. Conversion runs entirely in your browser.