Confluence to Markdown: 4 Ways to Export, Compared
Confluence to Markdown: 4 Ways to Export, Compared Short answer: Confluence Cloud can export pages to PDF and Word, and spaces to HTML, XML, CSV or PDF, but not to Markdown. For one page, you can copy the content into a Markdown editor or convert the HTML with Pandoc. For page trees, whole spaces or regular exports, use a Confluence Markdown exporter app such as the free Markdown Exporter for…
Confluence, the popular internal wiki platform, offers several ways to export its content to Markdown, a lightweight markup language often used for documentation. However, exporting to Markdown is not a built-in feature of Confluence Cloud. There are four primary methods to achieve this conversion, each with its own advantages and limitations.
Method 1 involves a manual copy-and-paste approach. Users can select the desired content on a page and paste it into a Markdown editor, which automatically converts the text. This method preserves headings, bold and italic text, simple lists, and links. However, it fails to handle images, tables with merged cells, code block languages, and the overall page hierarchy. Moreover, links to other Confluence pages still direct to the Confluence platform.
Method 2 requires a more technical solution using Confluence's REST API and a tool like Pandoc. Developers can fetch the page's HTML content via the API, then convert it to GitHub-flavored Markdown using Pandoc. This method offers the most control over the export process. It retains text, headings, lists, simple tables, and code blocks.
However, attachments and images need separate downloads and manual rewriting of image links. Links to other pages remain unchanged, pointing to Confluence's URLs. This method is best suited for developers who want complete control over the export.
Option 3 leverages the Markdown Exporter for Confluence app, a free tool available through Atlassian Forge. This app simplifies the export process, allowing users to select specific pages or entire spaces and export them as a ZIP file containing Markdown files. Attachments are saved in a dedicated folder with relative paths, ensuring images display correctly after unzipping.
Links between pages are rewritten as relative .md paths or Obsidian-compatible wikilinks. YAML front matter is generated for each page, including metadata such as title, author, date, and page ID. This option provides a structured Markdown export, making it ideal for developers moving content to Git repositories or static site generators.
Finally, Option 4 targets teams that use Markdown both in Confluence and in other tools like Obsidian. Markdown Importer for Confluence, another free app, supports bidirectional conversion between Confluence and Markdown. It exports pages, pages with children, or entire spaces as a ZIP file, preserving the hierarchy as folders and linking attachments through relative paths.
Links between pages are converted to relative .md paths or Obsidian-style wikilinks. While this app lacks some advanced features of the standalone Markdown Exporter, it offers a convenient solution for two-way synchronization between Confluence and Markdown-based tools.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.
