CONFLUENCE CLOUD · HOW-TO
How to export Confluence pages to Obsidian
Make a Markdown copy of selected pages, then inspect the notes and assets in an Obsidian vault.
Flint Markdown Export creates files from pages you can read in Confluence. It is an export, not a continuing sync: later changes in Confluence do not automatically update the downloaded copy.
Try a small handbook first
The interactive Markdown export demo uses fictional pages and offers a real downloadable sample. All sample pages start selected. Keep Onboarding and Architecture overview selected, choose the Obsidian vault preset, and inspect the pages. Leave Release checklist selected to see an unsupported-macro warning. The preset uses wikilinks and filenames with titles and page IDs.
Export your pages
- In Confluence, open a page’s more-actions menu and choose Apps → Export to Markdown. Choose the page, its descendants, or pages from a space, then select the pages you need.
- Choose the Obsidian vault preset. Accessible images are included within the export limits; enable Include other attachments if you also need files such as PDFs.
- Choose Review selection → Prepare full preview. Inspect the prepared files and warnings, including any unsupported macros or omitted items. Build the ZIP from the preview and choose Download ZIP.
- Extract the ZIP while keeping the page folders, Markdown files and adjacent
.assetsfolders together. For an existing vault, copy that hierarchy into a suitable folder, checking for filename conflicts first. To start separately, extract to a new folder and use Obsidian’s Open folder as vault option. - Open several notes in Obsidian. Follow links between exported notes, check images and attachments, and compare complex tables and macro content with the Confluence originals. Review the warnings and
manifest.jsonfor omissions before relying on the copy.
What happens to links and formatting?
Links between selected pages use the chosen output style; links to pages outside the export remain pointed at Confluence. Complex tables can retain HTML, and some macros may produce a marker and warning instead of their original content. Rendering can differ between the preview and Obsidian. Keep the exported hierarchy together and test links and images after moving files.
Can I use an existing vault?
Yes. An Obsidian vault is a folder on your device, so you can add the extracted files to it. Check for conflicts and inspect the result before replacing anything. The downloaded files do not inherit Confluence access controls; handle them according to your organization’s sharing and retention policies.
See the complete Flint Markdown Export guide for selection, presets, ZIP contents and limits, and the Flint Markdown Export Marketplace listing for the app. Obsidian’s documentation explains creating or opening a vault and internal links. Browse all Markdown Export guides for more destinations and export techniques. For another Confluence workflow, see how to filter Confluence tables.