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

What are best practices for exporting product documentation from Confluence to HTML

I am working on a new project where the product documentation is in a Confluence wiki. There is now a requirement to export that documentation to HTML so that it can be bundled and installed with the product and accessed directly (and locally) from the GUI application. I’ve read through the forums and seen where people have done similar things, but I’m wondering if I could get a consolidated set of advice / best practices here.

I think we have the following requirements. The solution must:

  • Provide both graphical and programmatic access so that either a user can manually do the export or an automated process can programmatically start the HTML export.
  • Provide the ability to select a subset of content for export from entire space.
  • Enable visual customization of the HTML output with company / product branding.
  • Ideally, provide a collapsible TOC (e.g., left-pane tree nav).
  • Ideally, include a Search capability over the HTML content.

Note, I’ve experimented with the Confluence HTML export, which I think could work for our needs with some custom CSS / development. However, I also see some add-ons and plug-ins (e.g., Custom Exporter and/or Auto-exporter for Confluence) that look promising. Any inputs on use of these or other tools would be appreciated. We are a small team, so we’ll need to weigh the costs/benefits of internal development and support vs. an off-the-shelf solution.

Thanks in advance.

1 comment

Hi Alan,

Have you also had a look at the Marketplace app "Scroll HTML Exporter"?

As vendor of the product these answers always sound like marketing... however the product allows you to implement all of your requirements.

  • both UI and REST interface are available
  • supports different page selection strategies (set of pages to be exported)
  • custom themes can be uploaded (just fork ours and extend)
  • tree navigation supported
  • JS based search index included

Beside that it offers much more e.g. the theme you can fork is also optimized for mobile devices...

Best, Tobias


Log in or Sign up to comment
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,033 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