export to markdown
Asked by Martin Soderstrom:

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.

Marty


Answers:
author: Nar Kumar C. - Narva Software
body: Hi Martin, we recently released add-on: [Markdown Exporter for Confluence](https://marketplace.atlassian.com/apps/1221351/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 <https://marketplace.atlassian.com/apps/1221351/markdown-exporter-for-confluence> and let us know if you face any issues.

Thanks

comments: author: Roman Mellenberger
body: Hi - ist there a way to do the export using a commandline tool (e.g. powershell)?


author: Nar Kumar C. - Narva Software
body: There is currently no option to do it using command line tool.

However, we have added **bulk export** feature, so you can export a full page hierarchy as well as the entire **space** including images and attachments.

You can try it from here ? [Markdown Exporter](https://marketplace.atlassian.com/apps/1221351/markdown-exporter-for-confluence?hosting=cloud&tab=overview)

![Bulk-Export.png](https://community.atlassian.com/t5/image/serverpage/image-id/269936i7858368B3C69D924/image-dimensions/574x281?v=v2 "Bulk-Export.png")


author: KO89
body: 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.


author: Atly Apps
body: Hi [@KO89](/t5/user/viewprofilepage/user-id/1173523), we've just released [an addon](https://marketplace.atlassian.com/apps/1227287/export-to-markdown-for-confluence-cloud) which supports exporting both individual Confluence pages and blog posts to Markdown, as well as entire spaces at once (to a ZIP file):

[![3.png](https://community.atlassian.com/t5/image/serverpage/image-id/179458i798BDD6E73E744CB/image-size/large?v=v2&px=999 "3.png")](https://marketplace.atlassian.com/apps/1227287/export-to-markdown-for-confluence-cloud)

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


author: Deepak Mishra
body: There is a project on GitHub called Turndown that lets you convert HTML to markdown.

[https://domchristie.github.io/turndown/](https://domchristie.github.io/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. <https://metamug.com/article/productivity/confluence-to-markdown.html>

comments: author: Guy
body: Dom Christie solution is great. I added a small plugin to support specifics of Confluence. Hope this helps.

<https://github.com/guyplusplus/turndown-plugin-confluence-to-gfm>


author: Gabriela Costa
body: Hi [@Martin Soderstrom](/t5/user/viewprofilepage/user-id/870209) :) 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](https://marketplace.atlassian.com/apps/1215703/markdown-extensions-for-confluence)


author: Rob Woodgate
body: HI Martin,

You might find this previous question helpful: <https://answers.atlassian.com/questions/235590>. I don't think much has changed since then on the Atlassian side.

However, there are 3rd parties looking at this, for example: <https://www.npmjs.com/package/confluence-to-github-markdown> 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.


Tags: cloud

confluence-cloud

documentation

gitlab

markdown