# Preparing your site for Docusaurus v3

DevFeed: [Preparing your site for Docusaurus v3](<https://devfeed.tech/articles/preparing-your-site-for-docusaurus-v3-40936.md>)

Original publisher: [Read original article](<https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3>)

Author: Sébastien Lorber

Published: 2023-09-29T00:00:00Z

Content type: tutorial

Language: en

Sources: [Docusaurus Blog](<https://devfeed.tech/sources/docusaurus-blog.md>)

Topics: [MDX](<https://devfeed.tech/topics/mdx.md>), [upgrade](<https://devfeed.tech/topics/upgrade.md>), [Markdown](<https://devfeed.tech/topics/markdown.md>)

Tags: [blog-post](<https://devfeed.tech/tags/blog-post.md>), [guide](<https://devfeed.tech/tags/guide.md>), [maintenance](<https://devfeed.tech/tags/maintenance.md>), [mdx](<https://devfeed.tech/tags/mdx.md>), [upgrade](<https://devfeed.tech/tags/upgrade.md>)

## AI overview

This tutorial explains how to prepare a Docusaurus v2 site for upgrading to Docusaurus v3. It focuses on the breaking changes involved in moving from MDX v1 to MDX v3, along with other preparation steps such as updating dependencies, testing for visual regressions, and adapting Markdown content.

## Source excerpt

This blog post was written when Docusaurus v3 was in beta. There are some changes in dependency versions and upgrade steps you should be aware of if upgrading to Docusaurus v3 current stable releases. Use the upgrade guide for the most up-to-date migration steps.