Markdown Exporter for Confluence (Bulk & Attachments) - User Guide
Export any Confluence page (or an entire page tree) to clean Markdown files, with attachments included in one ZIP download.
1. Quick Start
Step 1 — Open any Confluence page you want to export.
Step 2 — Click the ··· (More actions) button in the top-right corner, then navigate to Apps → Markdown Exporter.
Step 3 — Choose Single Export or Bulk Export in the dialog that appears.
Step 4 — Click Export. Your file (or ZIP archive) will download automatically.
2. Interface Overview
Element | Description |
|---|---|
Single Export | Export the current page only as a |
Bulk Export | Export the current page and all its child pages as a |
Include attachments toggle | When enabled, all page attachments are bundled into the ZIP alongside the Markdown files |
Documentation | Link to online documentation |
Support | Link to support / feedback |
3. Features
3.1 Single Export
Exports the currently open Confluence page as a single Markdown (.md) file. The page content — headings, tables, code blocks, images, and links — is converted to standard Markdown syntax.
Best for: Exporting individual articles, runbooks, or notes.
3.2 Bulk Export
Exports the current page together with all its child pages as a single .zip archive. The directory structure inside the ZIP mirrors the Confluence page hierarchy.
Each page appears as a row with its title and a paperclip badge showing the number of attachments.
All pages are selected by default; uncheck any page to exclude it from the export.
The export tree is fully expandable/collapsible.
Best for: Migrating an entire space section, documentation sets, or runbook libraries to another platform (e.g., GitHub, GitLab, Notion).
3.3 Attachment Support
Each page that has attachments shows a paperclip icon with a count (e.g., 📎 1) in the page list. Click the icon to preview the attachment list before exporting.
When Include attachments is enabled, attachments are saved in an attachments/ subfolder next to each page's Markdown file.
3.4 Export Progress
Once you click Export, each row updates in real time to show its processing status.
A green ✓ Processed label confirms that the page (and its attachments) have been successfully exported.
3.5 Output Structure
The downloaded ZIP preserves the full page hierarchy. Each page becomes a .md file, and pages with attachments have a corresponding attachments/ folder.
Example structure:
Incident Runbooks/
├── Incident Runbooks.md
├── attachments/
│ └── IT ops incident runbooks banner.png
├── RB - Logstash monitoring.md
├── RB - Billing Health Monitoring.md
├── Known Errors & Workarounds/
│ ├── Known Errors & Workarounds.md
│ ├── attachments/
│ │ └── Known Error KB banner.png
│ ├── KE - Billing Service - Checkout Error/ Inactive Item.md
│ └── KE - Billing Service - Checkout Error/ Linked Value 99.md
└── ...4. Configuration
Include Attachments Toggle
Located at the bottom-left of the dialog. This is a global setting that applies to both Single Export and Bulk Export.
State | Behavior |
|---|---|
ON (default) | Attachments are downloaded and placed in |
OFF | Only Markdown ( |
Tip: Turn off attachments if you only need the text content and want a smaller download.
5. FAQ
Q: Are child pages automatically included in a Single Export?
No. Single Export only exports the current page. Use Bulk Export to include child pages.
Q: Can I select which pages to include in a Bulk Export?
Yes. In the Bulk Export page tree, uncheck any pages you want to exclude before clicking Export.
Q: What happens to inline images?
Inline images are treated as attachments. With Include attachments enabled, they are saved in the
attachments/folder and the Markdown file references them with a relative path.
Q: What file format is the Bulk Export download?
A single
.zipfile containing all.mdfiles and, optionally,attachments/folders.
6. Quick Reference
Task | Steps |
|---|---|
Export current page |
|
Export page + children |
|
Exclude a child page | Bulk Export → uncheck the page → Export |
Skip attachments | Toggle Include attachments OFF before exporting |
Preview attachments | Bulk Export → click |