Confluence to Markdown Export — Free Online Converter
Export your Confluence pages to clean Markdown instantly. Paste Confluence HTML export or storage format and get clean .md output ready for GitHub, Obsidian, static site generators, or migrating away from Confluence. Our Confluence Markdown converter strips macros, handles tables, and preserves formatting — all 100% client-side so your data stays private.
Paste your Confluence HTML here
Export your Confluence page as HTML (Space Tools → Export, or Browser → Save As), then paste the HTML content below. You can also drag & drop an .html file.
Confluence Macro Handling
Automatically strips Confluence storage format macros: code blocks (ac:structured-macro), info/tip/warning panels, table of contents, children display, and more. Converts what's useful, discards what isn't.
Table & Task List Support
Confluence tables with merged cells and complex formatting are converted to clean Markdown tables. Task lists with checkboxes become - [x] Markdown task list items.
User Mentions & Emoji
Confluence @mentions are preserved as plain text mentions. Emoji shortcuts and inline images are handled gracefully — no more broken Confluence markup in your exported Markdown.
Private & Instant
Zero server processing — Turndown.js runs entirely in your browser. Your Confluence content never leaves your device. No account, no API key, no limits. Convert as many pages as you need.
How to Export Confluence Pages to Markdown
There are several ways to get your Confluence content into Markdown. Here are the most effective methods:
Method 1: PageText Web Converter (Easiest)
Use the converter above. Export your Confluence page as HTML (via Browser → Save As or Space Tools → Export to HTML), then paste the HTML into the converter. Get clean Markdown instantly — no installs, no scripts.
Method 2: Confluence REST API
Fetch Confluence page content programmatically via the /rest/api/content/{id}?expand=body.storage endpoint. Pipe the storage format HTML through PageText's converter for automated workflows. Ideal for CI/CD pipelines and bulk migrations.
Method 3: Atlassian Marketplace Apps
Apps like "Markdown Exporter for Confluence" or "Scroll Markdown Exporter" integrate directly into Confluence. However, many are paid and require admin permissions. PageText is free and requires no Confluence admin access.
Method 4: Pandoc (Advanced)
Export Confluence to HTML, then run pandoc input.html -f html -t markdown -o output.md. Pandoc handles many edge cases but requires command-line setup. Use PageText for quick, no-setup conversions.
Confluence to Markdown Conversion Example
See how a typical Confluence page (with macros, tables, and rich formatting) gets transformed into clean Markdown:
Confluence HTML (Storage Format)
<h1>Sprint Retrospective</h1> <p>Sprint #42 by <ac:link> <ri:user ri:userkey="..."/> </ac:link> @jane</p> <ac:structured-macro ac:name="info"> <ac:rich-text-body> <p>This is an info panel.</p> </ac:rich-text-body> </ac:structured-macro> <h2>Action Items</h2> <ac:task-list> <ac:task> <ac:task-status>complete</ac:task-status> <ac:task-body>Fix login bug</ac:task-body> </ac:task> </ac:task-list> <table><tr><th>Item</th> <th>Status</th></tr> <tr><td>Deploy</td> <td>Done</td></tr></table>
Clean Markdown Output
# Sprint Retrospective Sprint #42 by @jane > **Info:** This is an info panel. ## Action Items - [x] Fix login bug | Item | Status | |--------|--------| | Deploy | Done |
Frequently Asked Questions
How do I export Confluence pages to Markdown?
The easiest way is to use PageText's free Confluence to Markdown converter. Go to your Confluence page, use the 'Export to HTML' option (via Space Tools or Browser > Save As), open the exported HTML file, copy its source, and paste it into the converter above. It strips Confluence-specific markup and produces clean Markdown ready for GitHub, Obsidian, or static site generators.
Is this Confluence to Markdown converter free?
Yes, completely free. No sign-up, no usage limits, no API keys needed. All conversion happens client-side in your browser using Turndown.js with Confluence-specific rules — your content never leaves your device.
Does it handle Confluence macros and special formatting?
Yes. Our converter includes special rules for Confluence storage format: it handles code-block macros (ac:structured-macro), info/tip/warning panels (converted to blockquotes with emoji), task lists (converted to - [x] syntax), emoji shortcuts, and user @mentions. Confluence-specific wrapper divs and data attributes are stripped to produce clean, portable Markdown.
Is my Confluence data private?
Absolutely. All conversion happens entirely in your browser — your Confluence HTML content never leaves your device. No data is uploaded, stored, or transmitted to any server. PageText processes everything client-side using JavaScript.
What Markdown flavor does the output use?
The converter outputs standard CommonMark-compatible Markdown with ATX-style headings (#), fenced code blocks (```), asterisk bold/italic, and dash-based unordered lists. This format works with GitHub, GitLab, Obsidian, Notion, Hugo, Jekyll, MkDocs, Docusaurus, and most static site generators and documentation platforms.
Why should I export Confluence to Markdown?
Markdown is the universal format for developer documentation. It's version-controlled (Git-friendly), works with static site generators (MkDocs, Docusaurus, Hugo), integrates with CI/CD pipelines, and is portable across platforms. Exporting Confluence to Markdown helps you migrate documentation to GitHub wikis, convert internal wikis to public-facing docs, or maintain single-source documentation that works everywhere.
Can I use this for both Confluence Cloud and Server?
Yes. The converter works with HTML exports from both Confluence Cloud and Confluence Server/Data Center. Simply export your page as HTML (via browser Save As, Space Export, or the Confluence REST API) and paste the HTML content into the converter. It handles the storage format from both versions.
How does this differ from the HTML to Markdown converter?
The Confluence to Markdown converter builds on our HTML to Markdown tool with extra rules specifically for Confluence storage format: it strips ac: namespace macros, converts info/tip/warning panels to styled blockquotes, handles Confluence task lists with checkbox state, cleans up user mention markup, and preserves Confluence table formatting. The standard HTML to Markdown converter works fine for regular HTML — this one is tuned for Confluence exports.
Can I convert multiple Confluence pages at once?
Our web converter processes one page at a time. For bulk export, consider using Confluence's built-in Space Export (PDF or HTML), then use our HTML to Markdown converter for each page. For automated workflows, you can use the Confluence Cloud REST API combined with PageText's conversion tools.