DEV Community

Cover image for Export Confluence Pages to Clean Markdown — Introducing Markdown Exporter for Confluence
Yamuno for Yamuno Software

Posted on • Originally published at yamuno.com

Export Confluence Pages to Clean Markdown — Introducing Markdown Exporter for Confluence

Introducing Markdown Exporter for Confluence

We're excited to announce that Markdown Exporter for Confluence is now live on the Atlassian Marketplace.

Confluence's built-in export gives you HTML or PDF. Neither is portable. Neither fits a docs-as-code workflow. Neither works with Obsidian or a static site generator. For teams that live in both Confluence and Markdown — developers, technical writers, and DevOps teams — that gap has been a constant friction point.

Markdown Exporter for Confluence closes it.

Markdown Exporter for Confluence

What Is Markdown Exporter for Confluence?

Markdown Exporter is a Forge-native Confluence Cloud app that exports any page, page hierarchy, or entire space to clean, well-structured Markdown — without leaving Confluence and without sending data outside Atlassian's infrastructure.

The output is readable, portable Markdown that works immediately with MkDocs, Docusaurus, Obsidian, GitHub, GitLab, and any tool that understands the format.

Key Features

Single Page, Tree, or Full Space

Export exactly the scope you need:

  • Single page — export any Confluence page to a .md file in one click
  • Page tree — select a parent page, choose which child pages to include, and download a structured ZIP
  • Full space — export an entire Confluence space with the full page hierarchy preserved as folders

Multi-page exports are bundled into a ZIP that mirrors your Confluence structure.

YAML Front Matter

YAML Front Matter

Optionally include YAML front matter at the top of every exported file. Built-in fields include title, author, date, space, and confluence_id — each individually toggleable. You can also define your own custom key-value fields to tag exports for downstream pipelines or static site generators.

Obsidian Wikilinks Mode

Enable Obsidian mode and all internal Confluence page links are automatically converted to [[Page Title]] wikilink format. Drop the export into your Obsidian vault and the links resolve as if they were native notes.

Custom Filename Patterns

Custom Filename Patterns

Define how your exported files are named using {title}, {date}, and {id} tokens. Useful for building archives where filenames need to be predictable, sortable, or unique.

Live Markdown Preview

Before downloading, preview the rendered Markdown of any page. What you see in the preview is exactly what ends up in the file — no surprises.

In-Tree Search

Search pages by title directly in the export tree with live highlighting. Useful when you're working with large spaces and only need a specific subset of pages.

Runs Entirely on Atlassian Forge

Markdown Exporter is 100% Forge-native. All processing happens inside Atlassian's infrastructure. Exported files are delivered directly to your browser — nothing is stored on external servers.

Who Is It For?

Markdown Exporter is built for teams that need their Confluence content outside Confluence:

  • Developers syncing documentation with Git repositories or publishing to static sites
  • Technical writers migrating content between platforms or maintaining a backup in a readable format
  • DevOps and platform teams building docs-as-code pipelines where Confluence is the editing surface and Git is the source of truth
  • Obsidian users who want their team's Confluence knowledge base available as a local, searchable vault
  • Anyone running a Confluence migration who needs clean Markdown output as the intermediate format

Getting Started

  1. Install the app from the Atlassian Marketplace
  2. Open any Confluence page and click ••• (More actions) → Export to Markdown
  3. Choose your scope — single page, page tree, or full space
  4. Configure options — front matter, filename pattern, Obsidian mode
  5. Preview, then export and download your Markdown files

👉 Install Markdown Exporter for Confluence

👉 Read the Documentation


Questions or feedback? Reach out via our support portal — we'd love to hear how your team is using it.

Top comments (0)