Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

export to markdown

Hey, guys.  We're using Confluence for our documentation so dev can add raw content, etc.  For producing finished documents, we've been using the Scroll PDF Exporter (and sometimes the Scroll HTML Exporter).  

Now, we want to get the documentation up onto a GitLab developers site.  We're using Hugo and Markdown source.  Up until now, we've just been putting the PDF files up, but now they want the docs to be more integral to the site.

Any suggestions on how to get Markdown out of Confluence?

FYI, we use included pages and a few tables, just to complicate things.

Thanks for any help you can provide.



4 answers

Hi Martin, we recently released add-on: Markdown Exporter for Confluence

It exports Confluence contents (pages) to standard markdown format, which you can download locally.

Please give it a try from Marketplace and let us know if you face any issues.


Hi - ist there a way to do the export using a commandline tool (e.g. powershell)?

Like Jo Wilkes likes this

Sorry, there is currently no option to do it using commandline tool.

From what I see of your tool it only allows someone to export pages individually. I need to export a Confluence space as markdown so this tool won't work for me unless it's updated.

Like Benjamin Duguid likes this

Hi @KO89, we've just released an addon which supports exporting both individual Confluence pages and blog posts to Markdown, as well as entire spaces at once (to a ZIP file):


Please don't hesitate to contact us if you have any questions or suggestions.

There is a project on GitHub called Turndown that lets you convert HTML to markdown.

Confluence has steps to download a page or a set of pages as HTML. After you export to HTML you can copy the section of HTML from the zip file and convert it using turndown.


I have written an article with all the steps.

Dom Christie solution is great. I added a small plugin to support specifics of Confluence. Hope this helps.

Hi @Martin Soderstrom :) I know this doesn't directly answer your question, but if you ever find yourself trying to do the opposite (display GitHub markdown in confluence), check out Markdown Extensions for Confluence

HI Martin,

You might find this previous question helpful:  I don't think much has changed since then on the Atlassian side.

However, there are 3rd parties looking at this, for example:  I've got no idea how well that tool works, but it might be worth looking at, especially if you've got a lot of pages to convert.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . 🙋‍♀️ ...

1,032 views 18 28
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you