# What changed in @easyops-cn/docusaurus-search-local > 29 changes in @easyops-cn/docusaurus-search-local 0.52 to 3 from its official release notes, upgrade guides and advisories: 12 breaking, 6 new APIs and options. Each one cited. Sources checked 2026-10-22. HTML: https://unstale.sh/npm/@easyops-cn/docusaurus-search-local/ To see which of these apply to a repository, run `npx @unstale/cli init` in it. ## @easyops-cn/docusaurus-search-local 3 ### Breaking changes - The MDX parser now strictly follows CommonMark emphasis rules, changing how emphasis markers work around spaces and punctuation. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - Custom plugins may need refactoring or a rewrite because the new AST is structured differently. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - Official Unified, Remark, and Rehype packages are ESM-only and no longer support CommonJS require; use ESM configuration or dynamic imports. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - MDX no longer transforms indented text into code blocks; use regular fenced code block syntax instead. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - Docusaurus v3 parses directives through remark-directive; unhandled directives are ignored and are not rendered in their original form. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - MDX compiles Markdown more strictly, so content that compiled in Docusaurus v2 can fail or render differently and may need refactoring. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - Custom mappings are sandboxed: lowercase mappings apply to Markdown elements but not JSX elements, and lowercase custom element names are no longer substituted; use uppercase names for other elements. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - Docusaurus v3 requires Node.js >= 18.0; update local, CI, CDN, or host environments and the package engines field. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - Docusaurus v3 requires React >= 18.0; custom React code may be affected by React 18 breaking changes. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) ### New APIs and options - Docusaurus v3 supports ES Modules configuration files, allowing Remark plugins to be imported directly in the config. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) ### Tooling - Run the checker to list files that will fail to compile under MDX v3; it reports compilation errors, not subtle rendering changes. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) - TypeScript users should replace the external @tsconfig/docusaurus package with the official @docusaurus/tsconfig package. (3.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v3) ## @easyops-cn/docusaurus-search-local 2 ### Breaking changes - HTML elements in Markdown must be replaced by JSX elements. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/translated-sites) - MDX parses Markdown more strictly and makes builds fail on errors instead of rendering bad content. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/translated-sites) - Use the `` component with `id` and `description` to translate pages instead of the v1 `` component. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/translated-sites) ### New APIs and options - The build command can be run for one locale at a time with the `--locale` option. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/translated-sites) - Add this flag to convert Markdown to MDX automatically; the migration is still a work in progress. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/automated) - Add this flag to migrate pages automatically; the migration is still a work in progress. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/automated) - Code translations are added to this file using Chrome i18n JSON format. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/translated-sites) ### Tooling - The migration CLI automatically migrates a v1 website to a v2 website, including site configuration, package.json, sidebars, and site content. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/automated) ### Fixes and other changes - Localized content is generally found at this path in Docusaurus v2. (2.0.0) — [upgrade guide](https://docusaurus.io/docs/migration/v2/translated-sites) ## @easyops-cn/docusaurus-search-local 0.55 ### Behavior and default changes - open-ask-ai is now opt-in via an optional peer dependency. (0.55.0) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.55.0) ### Fixes and other changes - Refines the search icon. (0.55.3) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.55.3) - Fixes search for some languages that need lunr wordcut. (0.55.2) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.55.2) - On small screens (max-width: 576px), the search caret moves to the end of the input when focused or when the search bar is reopened. (0.55.1) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.55.1) ## @easyops-cn/docusaurus-search-local 0.54 ### Behavior and default changes - open-ask-ai is now asynchronous and optional. (0.54.0) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.54.0) ### Fixes and other changes - Fixes an error caused by reading toLowerCase from undefined. (0.54.1) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.54.1) ## @easyops-cn/docusaurus-search-local 0.53 ### New APIs and options - Ask AI is now supported. (0.53.0) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.53.0) ## @easyops-cn/docusaurus-search-local 0.52 ### Fixes and other changes - SearchBar is wrapped with DocsPreferredVersionContextProvider for compatibility with Docusaurus 3.9+. (0.52.2) — [release notes](https://github.com/easyops-cn/docusaurus-search-local/releases/tag/v0.52.2)