export to markdown

[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

[Nar Kumar C. - Narva Software]

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 https://marketplace.atlassian.com/apps/1221351/markdown-exporter-for-confluence and let us know if you face any issues.

Thanks

[Deleted user]

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

[Nar Kumar C. - Narva Software]

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

[KO89]

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.

[Atly Apps]

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.

[Deepak Mishra]

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

 https://domchristie.github.io/turndown/

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

[Guy]

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

[Gabriela Costa]

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

[Rob Woodgate]

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.