Best way to get HTML Help topics into Confluence? (And repurposing)

We have an HTML help system that runs inside our industrial software.

I'm transferring the Help topic pages to individual pages in Confluence. The HTML include macro won't work here because no one has set up our Confluence server to have HTTP access to the content management server where the HTML pages are.

Using the HTML macro seems to leave graphics and hyperlinks behind.

Does anyone have any good workflow tips or recommendations. Would copying the HTML topics to the Confluence server allow Confluence to include the HTML pages (without a web server running on the Confluence server also)?

Without some kind of sharing, I'm going to be pasting into Confluence pages, which leaves something to be desired.

5 answers

1 accepted


As you also questioned -

I do not think just copying the HTML into Confluence - even using the HTML macro - is going to give you the ultimate solution you need, for a repeatable online help context-sensitive links documentation process.

Maybe if you are in a rush and small help docset - you could do this quickly, manually, with some hacking a bit - and meet your date, assuming the admin fixes the html access issue. It is really easy for your admin to enable this - but they might not want to. Also yes, image links probably need to also be fixed for remote access or move the images into Confluence and reset them. Likely your navigation also breaks with this approach - so, again, not ideal process, for ongoing updates.

Assuming you do have time, to repurpose this longer term, here's some references to help you -

Hope these help -



Thanks Ellen for that great summary of information on this issue.

In this instance, because the online Help was small (35 topics), I pasted from HTML authoring tool (MS Expression Web 4) into Confluence pages. I uploaded image files as attachments to one Confluence page. I relinked the images to the topic pages, helped by the search in the image insertion dialog. I rebuilt the hyperlinks.

I'm going to check out all the references supplied above to figure out a more scalable, automatic method for my next project.

You can place directly the HTML pages in Confluence app. After all, confluence is just an web application.

I answered that once, but I cannot find the answer; the results will be nicely decorated (try to place a html page under confluence and see what's happening).

The downside of this is that you cannot search the pages, nor track the changes.

Yeap, thanks Renjith !

I'd suggest you consider using the SOAP remote API to programmatically add the HTML topics as pages into Confluence. To be exact you'd add the content of the body tags as the content of the new page. You could also manipulate the image references to pick these up as attachments from the page, otherwise you'd need to amend these manually after the import.

@docpro were you ever able to find a more scalable method to do this? I'm currently attempting something similar

AppFusions' plugin Doxygen for Atlassian Confluence is another way/consideration worth looking into.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,505 views 4 13
Read article

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you