This was just a quick preview of Docusaurus v3. More details in the blog post:. v3.0 does not come with a huge list of features, but is an important infrastructure upgrade. This sets the ground for a new wave of Docusaurus features we plan to implement!

Inject HTML data attributes with query-string / search params. This can be useful for various reasons.For example, you can customize CSS based on query-string params. Tip: use this to embed Docusaurus as an iframe in another website, and customize the layout. No FOUC expected!

We also upgraded Mermaid to v10. We support async diagram rendering, and new diagram types

Docusaurus v3 greatly improves TypeScript support. - Config files support TS.- New official base config.- Normalized TS exports.- Require TS 5.0+

React 18!. This comes up with all React 18 improvements. We'll soon explore how to properly support Suspense/React.lazy in Docusaurus. We also use the automatic JSX runtime, and you don't need to import React anymore

Unlisted content!. We had "draft: true" front matter. Now we have "unlisted: true" 🆕. This will publish your pages in production builds, but make them "secret". Impossible to discover: noindex, search, sitemap, RSS, sidebars. Ideal for getting final review before publication!

Now let's focus on a few features we particularly like. ESM and TypeScript configs!. This new support should greatly improve the Docusaurus DX!. And it's not only for your site config, but also docs sidebars, plugins, and preset modules!

Seb ⚛️ @sebastienlorber. MDX v1 ➡️ MDX v3 is the main challenge to adopt Docusaurus v3. Docs that compiled successfully under Docusaurus v2 might now fail to compile under Docusaurus v3. But we went the extra mile to make it less difficult for you!

Larger, more complex sites may require more work. We came up with a few strategies to help you upgrade more easily:. - Prepare your site ahead of time, while staying on v2. - Set up visual regression tests to catch unexpected visual changes.

Non-complex Docusaurus sites should be able to adopt v3 very easily. All you have to do is update a few dependencies and you're ready to go!

This is a new major version of Docusaurus, coming with new exciting features. We respect Semantic Versioning principles: this release also includes breaking changes. They are exhaustively documented in the v3 upgrade guide. Release blog post:

💥 Docusaurus v3.0 stable is available! 💥. ➡️ MDX 3. ➡️ React 18 / Automatic JSX runtime. ➡️ ESM + TS Config. ➡️ Unlisted content. ➡️ TypeScript 5. ➡️ Mermaid 10. ➡️ Node 18. ➡️ CommonMark (experimental). 🧵 Details below 👇

We are excited to share the Docusaurus V3.0 Release Candidate - explore what's new in this overview 🧵:.

Looks great 🤗.

💥 Docusaurus v3 first alpha is available! 💥. Please give this pre-release a try and share feedback!. Main breaking changes:.➡️ MDX v1 => v2.➡️ React v17 => v18. 🔗

RT @michaelfester: Today we are releasing a @markprompt plugin for @docusaurus-powered docs sites!. It's two lines of code. Thanks @remcoh….

💥 Docusaurus v2.4.1 is available! 💥. Little release fixing 2.4.0 bugs, notably:. 🐛 Collapsibles bug when prefers-reduced-motion is turned on.🐛 Algolia indexing SkipToContent.🐛 Markdown links with [link](<link>) . 🔗

Many other changes too!. Check the full changelog here:. This is likely the last 2.x minor release. The next one should be v3.0, including MDX 2 and React 18 🤞 🙌. 👋

🧵 Many translation improvements. New translations:.🇭🇺 Hungarian.🇳🇴 Norwegian (Bokmål). New DOCUSAURUS_CURRENT_LOCALE .➡️ experimental workaround to translate your site config: title, tagline, announcement bar.

🧵 Developer Experience improvements. Better error screens. Better navbar error messages, explain how to fix the problem. Display error cause messages (from ES2021 Error Cause)