Confluence to Markdown Converter

Confluence can export a page to PDF or Word and a space to HTML, XML, or PDF. There is no markdown option, and the HTML export is full of Confluence specific classes and macro markup that generic converters do not understand. The usual workarounds are a Marketplace app, which needs an admin to install, or a script against the REST API, which needs an API token.

Copying is simpler. When you copy a page, Confluence puts its rendered HTML on the clipboard. This converter reads that HTML, recognizes Confluence's panels, code blocks, status lozenges, mentions, Smart Links, tasks, and expands, and writes the markdown equivalent of each.

1. Open the page. View mode and edit mode both work.
2. Open every expand you want to keep. A closed expand does not copy its content.
3. Select the content. In view mode, drag from the title to the end of the page. In edit mode, click into the page body and press Cmd+A or Ctrl+A to select just the page.
4. Copy, then click the paste box above and paste.

Pasting into the box needs the formatted copy, so copy straight from Confluence rather than through a plain text editor.

Confluence Cloudrenders pages with Atlassian's newer editor. Copying gives panels, code blocks, status lozenges, and Smart Links with data attributes that this tool reads, so a Jira Smart Link comes through as [PAY-1423: Title](url) with its status.

Confluence Server and Data Center render macros as classic HTML: the info, tip, note, and warning macros, the code macro, the Jira issue macro, and inline tasks. Those convert too. If you have the page as wiki markup or as storage format from the REST API (expand=body.storage), paste it into the second tab instead.

• GitHub renders the panel callouts as colored alerts and the expands as collapsible sections, so a page moves into a README or wiki with little cleanup.
• Obsidian reads the same > [!NOTE] syntax as callouts. Put downloaded attachments next to the note and the image links resolve.
• Notion turns pasted markdown into blocks but does not know the callout syntax, so choose Plain blockquotes first.
• ChatGPT, Claude, NotebookLM, and RAG pipelines work better with markdown than with Confluence HTML. It keeps the structure and uses far fewer tokens.

Going the other way? The Markdown to Confluence converter turns markdown into formatted text or wiki markup for Confluence. For Jira tickets, use Jira to Markdown. For web pages, Google Docs, or Word, use the HTML to Markdown converter.