Confluence to Markdown converter
Paste a Confluence page and get GitHub-flavored Markdown you can copy or download. It reads the storage format (the XML with ac:structured-macro tags), exported HTML, and content copied straight from a page.
Runs in your browser. Nothing you paste or draw is uploaded.
Nothing leaves your browser.
How to use it
Step 1: Get the page. Select the content in Confluence and copy it, or export the space to HTML and open one of the .html files, or copy the page's storage format.
Step 2: Paste it into the box, or choose the .html file. The conversion runs as you paste.
Step 3: Check the Markdown and the Preview. Read the notes under the result: they list what could not be converted.
Step 4: Copy the Markdown, or download it as a .md file.
What gets converted
Headings, paragraphs, bold, italic, strikethrough, links, lists and tables. Code macros become fenced code blocks with their language. Info, note, warning and tip macros become GitHub alerts (or a plain labelled blockquote if you prefer). Task lists become checkboxes, expand macros become collapsible details blocks, and status and Jira macros become plain text. Images that point at attachments become .
A macro the converter does not know is left as an HTML comment, <!-- unsupported macro: name -->, so you can see where it was and fix it by hand. If the macro has a body, the body is kept.
Storage format or copied content
The storage format is what Confluence saves, so it keeps the most: macro names, parameters, task states, attachment names. Content copied from a rendered page is what the browser shows, so it works for text, tables and lists, but macros have already been turned into boxes and the converter has to guess from their look. If a callout or code block comes out plain, try the storage format.
Your page stays in your browser
The conversion is JavaScript running on this page. The text you paste is not uploaded, stored or logged; open your browser's network tab while you paste and you will see nothing sent. We count that the tool was used and which button was pressed, never what was in the box.
What it does not do
- One page at a time. A whole space or a page tree is a job for an importer, not a paste box.
- Images and attachments are not downloaded. The Markdown refers to them by file name; you bring the files.
- Macros that need Confluence to run (table of contents, page tree, include page, Jira issue lists, draw.io and Gliffy diagrams, user and page lists) cannot be reproduced and become comments.
- Merged table cells are split into empty cells, because Markdown tables cannot merge.
- Comments, page history, labels, permissions and page properties are not part of the page body and are not converted.
Moving a whole space?
Folio imports a page or an entire tree from Confluence, keeps images, footnotes, code and checkboxes, and stores the result as Markdown files in Git.
Questions
- Is my Confluence content uploaded anywhere?
- No. The converter runs in your browser and the text you paste never goes to a server. You can check this in your browser's network tab. Only a count of uses is recorded, never the content.
- Does it work with Confluence Cloud and Data Center?
- Yes. The converter reads the storage format and rendered HTML that both produce. Cloud pages also use some newer elements (for example ADF panels); where a Cloud macro is not recognised it is marked with a comment.
- Why did a macro become a comment?
- Some macros only make sense inside Confluence, such as a table of contents or a list of child pages. The converter marks each one with an "unsupported macro" comment instead of silently dropping it, so you can decide what to do in the new place.
- What happens to my images?
- They are written as . The files themselves are not in the paste, so download the attachments from Confluence and put them next to the .md file.
- Can I convert a whole space?
- Not here: this tool works on one page at a time. For a space or a page tree, Folio can import from Confluence through its API and keeps images, code and checkboxes.
- Which Markdown does it produce?
- GitHub-flavored Markdown: pipe tables, task lists, strikethrough and fenced code. Callouts use GitHub's alert syntax by default; switch to a plain blockquote if your renderer does not support alerts.
Updated 11 October 2026.
More free tools
All toolsAlso free: Markdown templates for meeting notes, SOPs, PRDs, runbooks and more.