Atly AppsDocumentation
Learn how to export or convert your Confluence Cloud pages and blog posts to Markdown — one page at a time, or an entire space as a ZIP file.
01Getting started
Export to Markdown for Confluence Cloud lets you easily export your Confluence pages and blog posts to Markdown — one at a time, or an entire space in a single ZIP file.
Before you begin: install the app from the Atlassian Marketplace. Once installed, the export actions appear automatically — no configuration required. A free 30-day trial is available.
02Export or copy a single page or blog post as Markdown
To export a single page or blog post to Markdown, click the three dots in the top-right of the page or blog post, then under Apps, select Export to Markdown.
A modal dialog opens with a live preview of your Markdown. Once you're happy with the preview, you can download the result or copy the Markdown to your clipboard.
The exported Markdown preserves headings, paragraphs, bold and italic text, code blocks with language identifiers, tables, and ordered and unordered lists. Here's an example of what the output looks like:
# Q3 Engineering Roadmap
## Goals
This quarter we are focused on improving **reliability** and reducing
_mean time to recovery_ across all production services.
## Key milestones
| Milestone | Owner | Due |
| ------------------- | ------- | ------- |
| Deploy observability stack | Platform | Jul 15 |
| Complete API v2 migration | Backend | Aug 1 |
## Rollout script
```bash
./scripts/deploy.sh --env production --version 2.4.0
```
03Export options & settings
From the Options menu in the modal dialog, you can configure how your content is exported:
When enabled, user comments on the page are appended to the exported Markdown below the page content.
When enabled, HTML tags are used in the output for content that can't be represented in standard Markdown — such as underline, superscript and subscript. Disable this if your target tool doesn't support inline HTML.
04Export an entire Confluence space to Markdown
You can export every page and blog post in a space to Markdown, bundled into a single ZIP file. Each page becomes its own .mdfile, with the space's hierarchy reflected in the folder structure.
- While viewing the space you'd like to export, go to Space settings.
- Under Integrations, select Export to Markdown.
- Choose your desired export options and select Export.
Once complete, download the ZIP file containing all of the space's content in Markdown.
What's included: all pages and blog posts, including nested child pages. Not included: file attachments (images, PDFs, etc.) and archived pages. For very large spaces the export may take a minute or two to complete.
05FAQ
Which Confluence plans does this work with?
Export to Markdown works with all Confluence Cloud plans, including Free, Standard, Premium and Enterprise. It is not compatible with Confluence Data Center or Server.
Are nested pages included in a space export?
Yes. All pages and blog posts are exported, including nested child pages. The folder structure in the ZIP file mirrors the page hierarchy in your space.
Are attachments included?
No — file attachments such as images and PDFs are not included in the export. The Markdown output will contain image references where images appeared inline, but the image files themselves are not bundled.
What Markdown flavour does the output use?
The output uses CommonMark-compatible Markdown, which is supported by GitHub, GitLab, Notion, Obsidian, and most other tools. Extended syntax — tables, fenced code blocks with language identifiers — is also included where supported.
Can I export a single section of a page?
The app exports the full page. To export only a section, copy the relevant Markdown from the live preview in the modal before downloading.
Can I use this to migrate to Obsidian, GitHub, Notion, or another tool?
Yes. The exported Markdown uses CommonMark-compatible syntax, which is supported by Obsidian, GitHub, GitLab, Notion, and most other tools that accept Markdown. For a full space migration, use the space export feature to download a ZIP of all your pages in one go, with the folder hierarchy preserved.
Does this work as a Confluence to Markdown converter?
Yes — Export to Markdown converts Confluence pages and blog posts to standard Markdown automatically. There is no manual conversion required: open a page, click Export to Markdown, and the converted Markdown is ready to download or copy immediately.
Is my data sent to Atly's servers?
No. Export to Markdown is built on Atlassian Forge and runs entirely on Atlassian's own infrastructure. Your content is never sent to or stored on Atly's servers.