Confluence to SharePoint Online Migration

Question

Hello,

I am currently trying to migrate all of the content in our internal Confluence wiki to SharePoint Online. So far I have been able to export a Confluence Space as HTML. What would be the best way of migrating those HTML pages to SharePoint?

So far I have several folders with the .html and .css files of the Confluence Spaces. I need to know how to import or create a SharePoint site from existing .html files (I can also get them as .xml files or even a .pdf).

If this isn't the best way to go about doing it, please let me know.

Note: I know that there's third party software (Tzunami, Enterprise Bridge, etc.) that can do this, but they are a bit expensive and I'd like to see if I can do this myself.

Answer 1

Hi @Exp-Mason ,

I'm glad to hear you solve the problem ,if you have any issue about SharePoint, you are welcome to raise a ticket in this forum.

By the way, since the Microsoft Q&A community has a policy that "The question author cannot accept their own answer. They can only accept answers by others.". and according to the scenario introduced here: Answering your own questions on Microsoft Q&A, I would make a brief summary of this thread:

[Confluence to SharePoint Online Migration]

Issue Symptom:
I am currently trying to migrate all of the content in our internal Confluence wiki to SharePoint Online. So far I have been able to export a Confluence Space as HTML. What would be the best way of migrating those HTML pages to SharePoint?

So far I have several folders with the .html and .css files of the Confluence Spaces. I need to know how to import or create a SharePoint site from existing .html files (I can also get them as .xml files or even a .pdf).

Current status:
I did find a solution. Here's a summary of the process, for anyone in the future to see:

Export all Confluence Spaces as HTML code.

Convert all .html files to .aspx files. You just need to rename them (I used a script to do this).

Replace any instance of ".html" inside the now-.aspx-files to ".aspx" (I also used a script to do this). If you don't, the links won't work as you have just renamed the files.

In SharePoint, enable custom scripts at both the tenant level and the site level.

Put the folder with the .aspx files and supplementary subfolders (attachments, images, styles, etc.) into the SharePoint Site's Documents page.

The "index.aspx" file will be the homepage for the migrated space.

You could click the "Accept Answer" button for this summary to close this thread, and this can make it easier for other community member's to see the useful information when reading this thread. Thanks for your understanding!

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

Answer 2

@Joerg Knoerchen
I tried to follow the solution. We are working with SharePoint Online in the Microsoft 365 environment.

The script I used to change the file extension .html into .aspx was simply the Windows Comman Line:
https://stackoverflow.com/questions/245840/how-do-i-rename-files-in-sub-directories

1. CD to the folder containing the export
2. for /r %x in (*.html) do ren "%x" *.aspx

To find all hyperlinks and change them from *.html into *.aspx I simply used Notepad function "Search & Replace" in that export directory.

I uploaded all to the SharePoint document library. Tried to open the index.aspx file.
But: this is not seen as a page obviously. It's downloaded like a document.

I guess those pages have to be in the Pages library?

Answer 3

Hi @Exp-Mason ,

We can use SharePoint Migration Tool to directly migrate .HTML(.xml or .pdf) files to SharePoint Online, however, they are only working as a file on the libraries, not a page. Due to compatibility issues, the migrated .html files may lose information during the editing process.
For your requirements, you may need to develop custom solution to convert your Confluence Space page to SharePoint .aspx page, or use third party tool.
There are some articles for your reference：
https://techcommunity.microsoft.com/t5/sharepoint-developer/migrating-html-to-modern-pages-looks-great-until-page-is-edited/m-p/222043
https://ashiqf.com/2020/08/08/hosting-static-html-content-in-sharepoint-online-site-azure/
https://sharepoint.stackexchange.com/questions/264764/custom-html-and-css-in-sharepoint

Note: Microsoft is providing this information as a convenience to you. The sites are not controlled by Microsoft. Microsoft cannot make any representations regarding the quality, safety, or suitability of any software or information found there. Please make sure that you completely understand the risk before retrieving any suggestions from the above link.

Thanks,
Yanli Jiang

===========================================

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".
Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.