@astrojs/mdx@8.0.0

withastro/astro@astrojs/mdx@8.0.0Aug 31, 2026by astrobot-houston

AI Summary

A major version update restructures how MDX files are processed by delegating logic to Markdown processors, requiring updated versions of those processors.

Key Highlights

MDX processing is now delegated to Markdown processors (unified/satteri).
Requires `@astrojs/markdown-satteri` 0.4.0+ or `@astrojs/markdown-remark` 7.3.0+.
Adds warnings for deprecated plugin options when not used by the processor.

Breaking Changes

Requires upgrading `@astrojs/markdown-satteri` to 0.4.0 or `@astrojs/markdown-remark` to 7.3.0 to maintain MDX functionality.
`.mdx` files now use a clean default processor if `extendMarkdownConfig` is false.

Full Release Notes

### Major Changes

-   [#17262](https://github.com/withastro/astro/pull/17262) [`f8e9458`](https://github.com/withastro/astro/commit/f8e94585ab6c38e2702ee1e2e540858f72058a40) Thanks [@Princesseuh](https://github.com/Princesseuh)! - Moves MDX file processing to the Markdown processors.

    '@astrojs/mdx' is still required to add MDX support to your project. However, it now delegates the MDX files processing to Markdown processors.

    #### What should I do?

    If you haven't explicitly installed a Markdown processor, you don't need to do anything.

    Otherwise, ensure that your configured Markdown processor uses the following version:

    -   `@astrojs/markdown-satteri` 0.4.0 or later if you use `satteri()`
    -   `@astrojs/markdown-remark` 7.3.0 or later if you use `unified()`

### Patch Changes

-   [#17262](https://github.com/withastro/astro/pull/17262) [`f8e9458`](https://github.com/withastro/astro/commit/f8e94585ab6c38e2702ee1e2e540858f72058a40) Thanks [@Princesseuh](https://github.com/Princesseuh)! - Fixes `.mdx` files still using `markdown.processor` when `extendMarkdownConfig` is `false`. They now use a clean default processor instead; pass `mdx({ processor })` to choose one explicitly.

-   [#17262](https://github.com/withastro/astro/pull/17262) [`f8e9458`](https://github.com/withastro/astro/commit/f8e94585ab6c38e2702ee1e2e540858f72058a40) Thanks [@Princesseuh](https://github.com/Princesseuh)! - Adds a warning when the deprecated `remarkPlugins`, `rehypePlugins`, `recmaPlugins` and `remarkRehype` options are ignored because your Markdown processor does not run them. They still apply when your processor is `unified()`, and were previously dropped silently otherwise.

-   Updated dependencies \[[`f8e9458`](https://github.com/withastro/astro/commit/f8e94585ab6c38e2702ee1e2e540858f72058a40), [`f8e9458`](https://github.com/withastro/astro/commit/f8e94585ab6c38e2702ee1e2e540858f72058a40)]:
    -   @astrojs/internal-helpers@0.11.0
    -   @astrojs/markdown-satteri@0.4.0