Confluence → Markdown

Overview

The Confluence-to-Markdown converter rewrites Atlassian wiki markup into Markdown. Headings, lists, tables, code macros, info/warning panels, and inline emphasis all get translated so you can lift a page out of Confluence and land it in a Git-tracked docs site without manual cleanup.

Teams migrating away from Confluence to MkDocs, Docusaurus, Hugo, or a plain GitHub wiki use a confluence converter to bulk-port pages. It also helps when you want to keep a longhand spec under version control instead of locked inside a SaaS UI.

How it works

Confluence supports two markup dialects: the legacy wiki syntax (h1., *bold*, {code}) and the newer XHTML-based storage format (<ac:structured-macro>). The converter detects which one you've pasted and applies the matching rule set.

For wiki syntax: h1. through h6. map to #–######, *text* becomes **text**, _text_ becomes *text*, {code:lang} blocks become fenced code with the language hint, and tables with || headers and | cells become GitHub-flavoured pipe tables. Panel macros ({info}, {warning}, {note}) collapse to blockquotes with a bold label.

Examples

Input:
h2. Setup

# Install
# Configure

{code:bash}
make build
{code}

Output:
## Setup

1. Install
2. Configure

```bash
make build

Input: bold and italic with {{inline code}}.
Output: bold and italic with inline code.

## FAQ

**Will it handle attachments and embedded images?**

Image references are converted to standard Markdown `![alt](url)` syntax, but attachment URLs are Confluence-internal and you'll need to download and re-host them. The converter leaves the URL intact so it's easy to find and replace later.

**What about Jira issue links?**

`[issue-key]` shortcuts are converted to plain Markdown links pointing at the Atlassian instance URL if you supply one; otherwise they're left as inline text for you to resolve.

**Does the XHTML storage format work?**

Yes. If you export a page as storage format (the raw XML), the converter handles `<ac:structured-macro>` blocks for code, info, warning, and note panels, plus the standard HTML elements.

Try Confluence → Markdown