# What changed in @astrojs/mdx > 39 changes in @astrojs/mdx 4 to 8 from its official release notes, upgrade guides and advisories: 6 breaking, 14 deprecations, 5 new APIs and options. Each one cited. Sources checked 2026-10-17. HTML: https://unstale.sh/npm/@astrojs/mdx/ To see which of these apply to a repository, run `npx @unstale/cli init` in it. ## @astrojs/mdx 8 ### Breaking changes - The minimum supported Node.js version is now 22.22.0, aligning with Astro's Node.js support policy and StackBlitz support. (8.1.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.1.0) - MDX files are now processed by Markdown processors, which must meet the required versions when explicitly configured. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) ### Deprecations - A warning is now emitted when this deprecated option is ignored because the configured Markdown processor does not run it. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) - A warning is added when recmaPlugins is ignored because the configured Markdown processor does not run it. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) - A warning is now emitted when this deprecated option is ignored because the configured Markdown processor does not run it. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) - A warning is now emitted when this deprecated option is ignored because the configured Markdown processor does not run it. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) - A warning is now emitted when this deprecated option is ignored because the configured Markdown processor does not run it. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) - A warning is added when remarkRehype is ignored because the configured Markdown processor does not run it. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) ### Behavior and default changes - YAML parsing now supports merge keys in MDX content. (8.0.3) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.3) - YAML parsing now supports timestamps and merge keys in MDX, and YAML errors are formatted consistently. (8.0.3) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.3) - With extendMarkdownConfig false, MDX uses a clean default processor; pass mdx({ processor }) to choose one explicitly. (8.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.0) ### Fixes and other changes - YAML errors are formatted consistently across Astro, Markdown, MDX, and Markdoc. (8.0.3) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.3) - Prevents installation with incompatible Astro versions and improves the error message to suggest updating astro. (8.0.2) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%408.0.2) ## @astrojs/mdx 7 ### Breaking changes - Upgrades to Vite v8, which may affect project build and development behavior. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.0) ### Deprecations - Importing getContainerRenderer() from the package root still works but is deprecated and logs a warning. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.0) ### New APIs and options - Adds a container-renderer entrypoint exporting getContainerRenderer() for MDX integrations. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.0) - Sätteri plugins can read and mutate frontmatter programmatically, with the result used as the MDX page's frontmatter. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.0) ### Fixes and other changes - Build errors for wrapped plugin errors now show the correct file location, line and column, and more accurate hints. (7.0.8) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.8) - Sätteri processor option types now accept all plugin entries supported by Sätteri v0.10.3. (7.0.8) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.8) - Fixes a bug where the integration emitted React-cased attribute names. (7.0.4) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.4) - Custom pre components now apply to syntax-highlighted code blocks when using the Sätteri Markdown processor with MDX. (7.0.3) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.3) - Corrects the dependencies declared in peerDependencies, improving dependency resolution for users installing the package. (7.0.1) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%407.0.1) ## @astrojs/mdx 6 ### Deprecations - The top-level option is deprecated; move it into unified({...}) or the preferred plugin processor. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) - The top-level option is deprecated; move rehype plugins into unified({...}) or the preferred plugin processor. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) - The top-level option is deprecated; move it into unified({...}) or the preferred plugin processor. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) - The top-level option is deprecated; move it into unified({...}) or the preferred plugin processor. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) - The MDX integration option is deprecated; move it onto unified({...}) or the preferred plugin processor. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) - The MDX integration option is deprecated; move it onto unified({...}) or the preferred plugin processor. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) - The MDX integration option is deprecated; move it onto unified({...}) or the preferred plugin processor. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) ### New APIs and options - Adds Prism syntax highlighting for code blocks in the Sätteri Markdown and MDX processors when markdown.syntaxHighlight is set to 'prism'. (6.0.3) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.3) - The MDX integration can use a different Markdown processor, allowing Sätteri for Markdown while retaining Unified for MDX. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) - Adds a configuration option to choose an alternative Markdown processor while keeping unified() as the default. (6.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%406.0.0) ## @astrojs/mdx 5 ### Breaking changes - Temporary support for Node >=20.19.1 was removed because Stackblitz now uses Node 22 by default. (5.0.2) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%405.0.2) - The Astro peer dependency requirement is updated to 6.0.0, affecting compatibility when installing or using this integration. (5.0.1) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%405.0.1) - Markdown heading ID generation was updated, which may change generated heading anchors. (5.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%405.0.0) ### Behavior and default changes - The minimum Node.js requirement was changed, including a lower requirement to support StackBlitz until it supports v22. (5.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%405.0.0) ### Fixes and other changes - Fixes an issue where the smartypants option was ignored. (5.0.6) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%405.0.6) - Detection of export const components declarations was fixed for projects using the optimize option. (5.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%405.0.0) ## @astrojs/mdx 4 ### Behavior and default changes - The returned object now includes a client hydration entrypoint, enabling client-side interactivity without manually calling container.addClientRenderer(). (4.3.10) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/mdx%404.3.10)