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.
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.
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. https://metamug.com/article/productivity/confluence-to-markdown.html
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.
- Create your own custom emoji 🔥 - "Shake for Feedback" on mobile 📱 - An endless supply of GIFs via GIPHY 🤩 Is there anything quite as nice as a pleasant surprise? Comment below with what...
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