Markdown Export

Convert any Confluence page — or your entire space — into clean, portable Markdown files. Export a single page in one click, or bulk-export a whole space as a structured ZIP archive.

🏷️ Confluence Cloud · v5.0.0

ℹ️Runs entirely on Atlassian

All exports are processed within your Atlassian environment. No data is sent to external servers. Your content stays inside Confluence.

📋Overview

The Export feature has two modes designed for different use cases:

📄Single Page Export

Export the current Confluence page as a single .md file. Triggered directly from the page's Apps menu. All formatting is preserved.

One click

📦Bulk Export (ZIP)

Export multiple pages — a subtree or the whole space — as a ZIP archive. Folder structure mirrors your Confluence hierarchy.

📄Single Page Export

Export any Confluence page to a .md file directly from the page view. Headings, lists, tables, inline code, code blocks, and links are all converted faithfully.

How to export a single page

Open the page you want to export
Navigate to any Confluence page in your space.
Open the page actions menu
Click the ··· (More actions) button at the top-right of the page to open the actions dropdown.
Select Apps → Markdown Exporter for Confluence
Hover over Apps in the dropdown, then click Markdown Exporter for Confluence from the submenu.
Download your .md file
The export dialog opens. Click Export to download the page as a .md file to your device.

💡Tip: Export directly from the Markdown Editor

If you are already writing in the Markdown Editor dialog, click the Export button in the top-right corner of the editor to download the current content as a .md file without leaving the editor.

📦Bulk Export

Bulk Export lets you download multiple pages at once as a structured ZIP file. Choose your export scope, select which pages to include, and download everything in one go.

How to run a Bulk Export

Open Markdown Exporter from any page
Click ··· → Apps → Markdown Exporter for Confluence.
Click "Bulk Export"
In the exporter dialog, select the Bulk Export option to open the scope selector.
Choose your export scope
Select one of the four scope options (detailed below). The Pages to include checklist updates automatically based on your selection.
Review and customise the page list
Uncheck any pages you want to exclude from the export. All pages are selected by default.
Click "Export ZIP"
A .zip archive is generated and downloaded to your device. Each page becomes its own .md file inside a folder structure that mirrors your Confluence hierarchy.

Export scope options

📄Current page only

Exports just the page you opened the exporter from, packaged as a ZIP containing a single .md file.

📁This page + direct children

Exports the current page and its immediate child pages (one level deep). Each page is saved as its own .md file in a folder.

🌲Full page tree

Exports the current page and all of its nested descendants. The folder structure mirrors your Confluence page hierarchy.

🌐Whole site (entire space)

Exports every page in the current Confluence space. All folders are preserved exactly as they appear in the space tree.

📂Output Format & File Structure

Each exported page is saved as a .md file. For Bulk Export, files are organised into a folder hierarchy inside the ZIP that matches your Confluence space structure.

Example ZIP structure (Full page tree)

space-export.zip
└── RVS/
├── index.md ← space root page
├── Getting-Started/
│ ├── index.md
│ ├── Installation.md
│ └── Configuration.md
├── API-Reference/
│ ├── index.md
│ └── Authentication.md
└── Troubleshooting/
└── index.md

What gets preserved in the Markdown output

Confluence Element	Markdown Output	Preserved?

Confluence Element	Markdown Output	Preserved?
Headings (H1–H6)	`# Heading` syntax	✓ Yes
Bullet & numbered lists	`-` and `1.` syntax	✓ Yes
Bold, italic, inline code	`bold`, `italic`, `code`	✓ Yes
Code blocks (with language)	Fenced ``` blocks with language tag	✓ Yes
Tables	Markdown pipe table syntax	✓ Yes
Hyperlinks	`[text](url)` syntax	✓ Yes
Blockquotes	`>` syntax	✓ Yes
Images (URL-based)	`![alt](url)` syntax	✓ Yes
Confluence macros	Converted where possible, otherwise omitted	~ Partial
Inline comments / annotations	Not included in output	✗ No

🚀Common Use Cases

Migrate docs to a Git repository

Use Whole site bulk export to get all your Confluence pages as .md files. The folder structure maps cleanly to a docs/ folder in your repository. Compatible with GitHub, GitLab, and Bitbucket.

Publish to a static site generator

Exported Markdown works out of the box with Docusaurus, MkDocs, Jekyll, Hugo, and Astro. The folder hierarchy produced by the ZIP export aligns with how these tools expect documentation to be organised.

Back up your space

Run a Whole site export periodically to keep an offline, version-controllable backup of your Confluence space content in a portable, human-readable format.

Share docs with external collaborators

Export specific pages or subtrees and share the .md files with contractors, partners, or open-source contributors who don't have Confluence access.

❓FAQ

Does the export include page attachments or images?▾

URL-based images are included using standard Markdown image syntax ![alt](url). File attachments uploaded directly to Confluence are not bundled into the ZIP export at this time.

Can I export pages from multiple spaces in one ZIP?▾

Not in a single export operation. Each Bulk Export is scoped to one Confluence space. You can run separate exports for each space and merge the ZIPs manually.

What happens to Confluence-specific macros in the export?▾

Standard macros (code blocks, panels, info boxes) are converted to their Markdown equivalents where possible. Complex or third-party macros that have no Markdown equivalent are omitted from the output.

Is there a limit on how many pages I can export at once?▾

There is no hard page limit imposed by the app. Very large spaces may take longer to process. If you experience timeout issues, try exporting a page subtree instead of the whole site.

Does exporting affect the original Confluence pages?▾

No. Export is a read-only operation. Nothing is modified, moved, or deleted in your Confluence space during or after an export.