Skip to main content

One post tagged with "maintenance"

View All Tags

· 14 min read
Sébastien Lorber

Docusaurus v3 is now in beta and the official release is around the corner. This is the perfect time to start preparing your site for this new major version.

Docusaurus v3 comes with a few breaking changes, many of which can be handled today under Docusaurus v2. Preparing your site ahead of time can be done incrementally, and will make it easier to upgrade to v3.

The most important Docusaurus v3 breaking change is the upgrade to MDX v2, which will compile your Markdown content more strictly and with subtle differences.

This article will mostly focus on how to prepare your content for this new MDX version, and will also list a few other breaking changes that you can handle today.

Preparing your site for Docusaurus v3 - social card