How to migrate from Confluence to Docusaurus

#documentation #webdev #docusaurus #node

Table of content

What is Confluence
What is Docusaurus
Step 1: Export Space from Confluence to HTML
Step 2: Convert HTML to Markdown (md)
Step 3: Setup Docusaurus

What is Confluence

Confluence is a tool that helps teams work together on projects and share information. It's made by Atlassian, and it works with other Atlassian products. Confluence is popular for storing and organizing team knowledge, documenting projects, and helping teams collaborate.

What is Docusaurus

Docusaurus is a free and open-source documentation website builder made by Facebook. It makes it easier for people, groups, and open-source projects to create and keep up-to-date documentation for their software or products. Docusaurus provides a simple, customizable, and easy-to-use documentation platform with features like versioning, search, and the ability to work with different content sources. It is often used by developers and teams to create well-organized and easy-to-navigate documentation sites.

Export Space from Confluence to HTML

Log in to your Confluence instance as a user with administrative or space admin privileges.
Navigate to the space you want to export.
In the left-hand sidebar, click on "Space settings."
In the Space Settings menu, look for "Content tools" and select "Export."
In the "Export Space" dialog, you can choose the export format. Select "HTML" from the list.
You can specify various export options, such as the file format, whether to include attachments, and other settings.
Click the "Next" or "Export" button to initiate the export process.
Confluence will generate an HTML version of the entire space, which you can download as a zip file.
Once the export is complete, click the link to download the HTML file to your computer.

Convert HTML to Markdown (md)

HTML and Markdown are both lightweight markup languages used to create formatted text. HTML is more complex and widely used, but Markdown is simpler and easier to read and write.

Follow the details on Article

Setup Docusaurus

It is a straightforward process. After installing Node.js and Yarn, you can create a new Docusaurus project using the command-line tool. Customize your documentation by editing Markdown files, and configure the site's appearance and functionality using the provided configuration files. Docusaurus simplifies the creation of professional-looking documentation websites, making it an excellent choice for developers and teams seeking an efficient and user-friendly solution.

Follow the details on Article