Docusaurus v3.9.0

v3.9.0

3.9.0

Added 11
  • Use DocSearch v4.1 with optimized integration in theme-search-algolia
  • Add support for email social icon in blog and resize default social icon
  • Add theme-tabs-container stable className to theme
  • Add runtime support for DocSearch v4
  • Resolve @site/* markdown links and fix resolution priority bugs
  • Support elk layout in mermaid theme
Changed 3
  • Upgrade Rspack to 1.5 and use lazyBarrel experiment
  • Upgrade Rspack to 1.4 in faster plugin
  • Use respectPrefersColorScheme in create-docusaurus init template
Fixed 5
  • Fix copy of indented code blocks and replace copy-text-to-clipboard by clipboard API
  • Remove hardcoded fill from Bluesky and LinkedIn icons
  • Render sidebar category index with unlisted children as a simple doc/link item
  • Add translate no to heading anchors and blog authors
  • Doc sidebar links and categories with long labels should display properly
Deprecated 1
  • Deprecate siteConfig.onBrokenMarkdownLinks
3.9.0 (2025-09-25)
:rocket: New Feature
  • docusaurus-theme-search-algolia
    • #11421 feat(theme-search-algolia): use DocSearch v4.1, optimize integration (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-theme-classic
    • #11425 feat(blog): Add support for email social icon + resize default social icon a bit (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11426 feat(theme): Add theme-tabs-container stable className (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-search-algolia, docusaurus-theme-translations
  • docusaurus-faster, docusaurus
    • #11415 feat(faster): upgrade Rspack to 1.5, use lazyBarrel experiment, remove deprecated option (@slorber)
    • #11294 feat(faster): Upgrade to Rspack 1.4 (@slorber)
  • docusaurus-utils
    • #11397 feat(mdx): resolve @site/* markdown links, fix resolution priority bugs (@slorber)
  • docusaurus-theme-mermaid
  • docusaurus-plugin-pwa, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-types, docusaurus-utils, docusaurus
    • #11316 feat(core): Add i18n.localeConfigs[locale].{url,baseUrl} config options, fix multi-domain deployments (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-types, docusaurus-utils, docusaurus
    • #11304 feat(core): add i18n.localeConfigs.translate + skip translation process if i18n/<locale> dir doesn't exist (@slorber)
  • docusaurus-plugin-content-docs
    • #11228 feat(docs): sidebar item key attribute - fix docs translations key conflicts (@slorber)
  • create-docusaurus
    • #11293 feat(create-docusaurus): use respectPrefersColorScheme in init template (@slorber)
  • docusaurus-mdx-loader, docusaurus-types, docusaurus
    • #11282 feat(core): add siteConfig.markdown.emoji config option to disable remark-emoji (@slorber)
  • create-docusaurus, docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
    • #11283 feat(core): Add siteConfig.markdown.hooks, deprecate siteConfig.onBrokenMarkdownLinks (@slorber)
:bug: Bug Fix
  • docusaurus-theme-classic, docusaurus
    • #11422 fix(theme): fix copy of indented code blocks, replace copy-text-to-clipboard by clipboard API (@slorber)
  • docusaurus-theme-classic
    • #11407 fix(theme): remove hardcoded fill from Bluesky and LinkedIn icons (@Simek)
    • #11389 fix(theme): render sidebar category index with unlisted children as a simple doc/link item (@slorber)
    • #11360 fix(theme): Add translate no to heading anchors and blog authors (@slorber)
    • #11356 fix(theme): Doc sidebar links/categories with long labels should display properly (@slorber)
    • #11338 fix(theme-classic): fix collapsed sidebar category expansion when navigating to another link within that category (@qqq614)
    • #11289 fix(theme): Fix footnote ref scrolling behind the navbar when footnote back reference clicked (@slorber)
  • docusaurus
    • #11410 fix(deps): upgrade webpack-dev-server to v5, fix security warning (@slorber)
    • #11347 fix(core): Fix docusaurus start on macOS when exec throws a synchronous error (@slorber)
    • #11271 fix(dev-server): use correct dev server HTML lang attribute (@enumura1)
  • docusaurus-theme-common
    • #11405 fix(theme): fix useColorMode() visual glitches due to provider unmounts/remounts (@slorber)
    • #11280 fix(theme-common): Export FooterColumnItem type (@stubinubin)
  • docusaurus-bundler, docusaurus-faster
    • #11383 fix(ssg): HTML minifier should preserve <head> for og:image crawlers (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-translations
    • #11331 fix(theme): Add aria-label to IconExternalLink with value '(opens in new tab)' (@WestonThayer)
  • docusaurus-plugin-content-docs
    • #11281 fix(docs): Fix empty sidebar item category className lost when post-processed to a doc (@slorber)
    • #11251 fix(docs): prevent docs ids conflicts within a version (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11263 fix(theme): make useHistorySelector() hydration-safe + use it read search/hash in theme (@slorber)
:memo: Documentation
:robot: Dependencies
:wrench: Maintenance
  • create-docusaurus, docusaurus-babel, docusaurus-bundler, docusaurus-cssnano-preset, docusaurus-faster, docusaurus-logger, docusaurus-mdx-loader, docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-css-cascade-layers, docusaurus-plugin-debug, docusaurus-plugin-google-analytics, docusaurus-plugin-google-gtag, docusaurus-plugin-google-tag-manager, docusaurus-plugin-ideal-image, docusaurus-plugin-pwa, docusaurus-plugin-rsdoctor, docusaurus-plugin-sitemap, docusaurus-plugin-svgr, docusaurus-plugin-vercel-analytics, docusaurus-preset-classic, docusaurus-remark-plugin-npm2yarn, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-mermaid, docusaurus-theme-search-algolia, docusaurus-theme-translations, docusaurus-utils-common, docusaurus-utils-validation, docusaurus-utils, docusaurus, eslint-plugin, lqip-loader
    • #11408 chore: drop support for Node 18, that reached End-of-Life (@slorber)
  • docusaurus-theme-classic
  • docusaurus-plugin-content-docs
  • docusaurus-bundler
    • #11290 chore: upgrade website to Rspack 1.4 + fix Rspack internal performance tracing (@slorber)
  • Other
    • #11287 chore(website): split changelog per version + adjust changelog plugin implementation (@slorber)
:globe_with_meridians: Translations
  • docusaurus-theme-translations
    • #11315 fix(theme-translations): Add missing Portuguese (pt-BR) theme translations and improve some of it. (@marcelocell)
    • #11305 fix(translations): Add missing Ukrainian translations (@maluke)
Committers: 18
View original

Upgraded? How did it go?

Discussion