Skip to main content

Working in Docusaurus

Docusaurus is built to be flexible and user-friendly, whether you are a developer or an editor. The platform makes it easy to create and maintain documentation sites that are fast, structured, and engaging.

Two ways to work

For developers

Developers will feel at home in Docusaurus, since the platform uses a file-based structure and modern development tools like React and Markdown. By using Git and version control, teams can collaborate effectively and keep track of changes. When everything is ready, it is easy to build and deploy the site, and it performs optimally thanks to pages being generated as static files.

🛠️ Workflow example: Add a new documentation page by creating a .md file, link it in sidebars.js, and build the site with a simple command.

For editors

Editors working with Docusaurus can benefit from integrations with graphical interfaces, such as CMS systems, which allow them to update content without writing code. It is just as easy to add new pages and blog posts as it is to work in a regular text editor. Layout and design are handled by Docusaurus, so editors can focus entirely on the content.

✏️ Tip: With the right CMS integration, editors can edit text directly via a user-friendly interface, without needing to understand the file structure.

Smooth collaboration

One of Docusaurus’s strengths is how it enables collaboration between technical teams and content creators. Developers can create components and define the structure, while editors focus on creating and updating content. This allows everyone to contribute their expertise, resulting in a well-functioning and professional site.

💡 Did you know? While developers can add custom functionality in React, editors can continue to work in Markdown without worrying about the technical implementation.

Is Docusaurus right for your team?

Perfect for – Teams where developers and editors collaborate on a technical level.
Good for – Small teams where a few people handle both code and content.
⚠️ Requires some technical knowledge – Editors without experience with Git or CMS may need support to get started.


Click "Next" to continue the tour and learn more about what Docusaurus can do!