How to convert Confluence to Markdown
- Use Public page for one page that anyone can view.
- Use HTML export ZIP for a full space or a group of pages.
- Select Convert to Markdown.
- Review the preview, then copy one page or download the Markdown files.
Convert one page or a full Confluence space
Confluence is Atlassian's team wiki and documentation app. A single public page works like any other webpage: Keep fetches its readable content and returns one Markdown file.
A migration needs more than one fetched page. Export the space as HTML in Confluence, then upload the ZIP. The converter finds each HTML page, removes export navigation, changes local page links from .html to .md, and keeps attachments beside the Markdown files.
How to create a Confluence HTML export
- Open the space settings in Confluence.
- Choose the space export option, then choose HTML.
- Export the full space or select the pages you need.
- Upload the downloaded ZIP here without extracting it first.
Confluence can also export one page to Word or PDF. Use the Word converter or PDF converter for those files.
What stays in the Markdown export
- Headings, paragraphs, lists, links, tables, code, and emphasis.
- Separate Markdown files for the HTML pages in the export.
- Relative links between converted pages.
- Downloaded attachments and their folder paths.
Confluence's HTML export does not include page comments or blog posts. Complex macros, embedded apps, permissions, and interactive controls can also need a manual check after conversion.
Frequently asked questions
Confluence is Atlassian software for team documentation, internal wikis, project notes, and shared knowledge bases.
For one public page, paste its URL. For a space or selected pages, create an HTML export in Confluence, upload the ZIP, then download the converted Markdown ZIP.
Yes. Upload the HTML space-export ZIP. The browser converts up to 500 HTML pages and keeps attachments in the downloaded ZIP.
Yes for an HTML export. Links between exported HTML pages are changed to .md links. Attachment files keep their relative paths in the output ZIP.
No. It can fetch one public page, or process an HTML export ZIP on your device. It does not use an Atlassian login or API token.
Yes. HTML export ZIP conversion runs in your browser and has no daily limit. Public URL conversion uses the shared allowance of five server-backed conversions each day.
Confluence HTML space exports do not include page comments or blog posts. The converter can only process the content present in the ZIP.
The ZIP can be up to 25 MB and contain up to 500 HTML pages, 2,000 files, and 100 MB of uncompressed data.