How to use the markdown to confluence converter
- Paste your Markdown into the text area.
- The Confluence wiki markup appears below automatically.
- Copy the result. In Confluence Server or Data Center, use Insert, Markup and choose Confluence Wiki. In Confluence Cloud, use the same menu where it is offered; otherwise the editor accepts Markdown directly and you may not need this conversion.
Supported Markdown subset
The converter implements a practical subset of CommonMark that covers most documentation needs for a markdown to confluence workflow:
- Headings
#through######becomeh1.toh6. - Emphasis
*text*or_text_becomes_text_ - Strong
**text**or__text__becomes*text* - Strikethrough
~~text~~becomes-text- - Inline code
`code`becomes{{code}} - Fenced code blocks (
```or~~~) become{code:lang}...{code}. A few common names are mapped to Confluence's names: js to javascript, py to python, sh and zsh to bash, yml to yaml. With no language the block is plain{code}. - Links
[text](url)become[text|url], and<https://...>becomes[https://...] - Images
become!url!(the alt text is dropped) - Unordered lists with
-,*or+become*, ordered lists become#, and nesting repeats the marker (**,#*) - Blockquotes
> textbecome{quote}text{quote} - Horizontal rules
---or***become---- - Pipe tables with a separator row become
||header cells and|body cells
Raw HTML is not interpreted: it is passed through as text, because wiki markup has no HTML escaping.
How the conversion works
The tool runs a line-oriented parser in your browser. It walks the lines while tracking code fences, lists and tables. Block-level structures are converted first; then inline markup is processed inside each block. Code spans, links, images and URLs are set aside before emphasis is rewritten, so underscores in a URL or code span are never read as italics. Wiki markup is not HTML, so characters are escaped with a backslash, not with entities: {, }, [ and ] become \{, \}, \[ and \], and a | inside a table cell becomes \|.
For example, the Markdown ## Section, then Text with **bold**., then a fenced python block containing print('hi') becomes h2. Section, Text with *bold*., and {code:python} ... {code}.
Common pitfalls
Nested lists are detected from the indentation of the Markdown source; use two or more spaces per level. A nested ordered list under a bullet gives *#, and a bullet under a number gives #*.
Table alignment is ignored; Confluence tables do not support column alignment. The separator row is only used to detect a table. Empty cells are written as a single space so they are not mistaken for header markers.
Images lose alt text because the converter writes the plain !url! form. Add alt text in Confluence if you need it.
HTML and entities in the input, such as © or <b>, are passed through unchanged. Write literal characters instead.
Reference: Markdown to Confluence quick table
| Markdown | Confluence wiki markup |
|---|---|
# H1 | h1. H1 |
*italic* | _italic_ |
**bold** | *bold* |
~~strike~~ | -strike- |
`code` | {{code}} |
```js ... ``` | {code:javascript} ... {code} |
[link](url) | [link|url] |
 | !url! |
- item | * item |
1. item | # item |
> quote | {quote}quote{quote} |
--- | ---- |
| A | B | then |---|---| then | 1 | 2 | | ||A||B|| then |1|2| |
Why use this markdown to confluence converter?
Confluence's wiki markup is a separate syntax from Markdown, used by the wiki markup editor and its Insert Markup option. When moving docs from GitHub, GitLab, or a static site generator, this tool converts the common constructs in one step. It runs entirely in your browser, so internal documentation never leaves your machine. Check the result in a preview before publishing, since macro names and language lists vary between Confluence versions.
Worked examples
| Example | Input | Result |
|---|---|---|
| Basic formatting | Markdown input: # Title / Paragraph with *italic* and **bold** and `code`. / --- / > Quote | h1. Title / Paragraph with _italic_ and *bold* and {{code}}. / ---- / {quote}Quote{quote} |
| Code block and list | Markdown input: ```python / def hello(): / print('world') / ``` / 1. First / 2. Second / - Nested | {code:python} / def hello(): / print('world') / {code} / # First / # Second / #* Nested |
| Table and link | Markdown input: [Atlassian](https://atlassian.com) / | Name | Role | / |------|------| / | Alice | Admin | / | Bob | User | | [Atlassian|https://atlassian.com] / ||Name||Role|| / |Alice|Admin| / |Bob|User| |
| Image and mixed | Markdown input:  / **Bold** and *italic* together. / - Bullet / - Another | !https://example.com/logo.png! / *Bold* and _italic_ together. / * Bullet / * Another |
FAQ
Does this support all Markdown features?
No. It covers the subset listed above. Footnotes, definition lists, task lists, HTML blocks, and complex table features are not supported.
Can I convert Confluence markup back to Markdown?
This tool only goes one way. For the reverse, use a dedicated Confluence-to-Markdown converter.
Why is my raw HTML shown as text?
Wiki markup has no HTML pass-through, so tags such as <b> are left as typed and will show as literal text in Confluence. Use Markdown formatting instead of HTML.
Why are my braces and brackets escaped?
In wiki markup, {...} starts a macro and [...] starts a link. A backslash before the character makes it literal text.
Does the tool work offline?
Yes. After the page loads, no network requests are made. You can disconnect and continue converting.
Are there limits on input size?
Input is limited to 500,000 characters. Split larger documents into parts.
Where do I paste the result?
In Confluence Server or Data Center, use the editor's Insert, Markup option and choose Confluence Wiki. Confluence Cloud's editor is not built on wiki markup, so the same option may be missing; Cloud accepts Markdown directly, which may make this conversion unnecessary there.
How does the markdown to confluence converter handle nested blockquotes?
Nested blockquotes are flattened into a single {quote} block, with the inner text on its own lines.