@astrojs/mdx

• 6.0.2

  Jun 3, 2026

  🐞 Patch Changes

  • #16955 9a93d68 Thanks @Princesseuh! - Updates Sätteri processor to v0.8.0. See its changelog for details on bugs fixed and features added.

  • Updated dependencies [9a93d68]:

    • @astrojs/markdown-satteri@0.2.2
• 6.0.0

  May 28, 2026

  ✨ Major Changes

  • #16848 f732f3c Thanks @Princesseuh! - Adds a new markdown.processor configuration option, allowing you to choose an alternative Markdown processor.

    Websites with many Markdown/MDX files tend to be slow to build because the unified ecosystem (e.g., remark, rehype) is slow to process. This feature introduces the ability to replace this part of the build pipeline with another processor.

    The default processor is unified(). This means that existing configurations remain unchanged and your remark/rehype plugins continue to work.

    import { defineConfig } from 'astro/config';
    import { unified } from '@astrojs/markdown-remark';
    import remarkToc from 'remark-toc';
    
    export default defineConfig({
      markdown: {
        processor: unified({
          remarkPlugins: [remarkToc],
        }),
      },
    });

    In addition to this new configuration option, Astro provides a new alternative processor based on Rust: Sätteri. You can choose to use it now by installing @astrojs/markdown-satteri, importing the satteri() processor, and adapting your existing configuration:

    import { defineConfig } from 'astro/config';
    import { satteri } from '@astrojs/markdown-satteri';
    
    export default defineConfig({
      markdown: {
        processor: satteri({
          features: { directive: true },
        }),
      },
    });

    This processor does not support the remark and rehype plugins. This means you may need to convert them to MDAST or HAST plugins to retain your current functionality.

    The existing top-level markdown.remarkPlugins, markdown.rehypePlugins, markdown.remarkRehype, markdown.gfm, and markdown.smartypants options still work, but are now deprecated and will be removed in a future major update. The matching remarkPlugins, rehypePlugins, and remarkRehype options on the MDX integration are also deprecated for the same reason. To anticipate their removal, move them onto unified({...}) (or your preferred plugin processor) :

    import { defineConfig } from 'astro/config';
    import remarkToc from 'remark-toc';
    import rehypeSlug from 'rehype-slug';
     import { unified } from '@astrojs/markdown-remark';
    
    export default defineConfig({
      markdown: {
        processor: unified({
          remarkPlugins: [remarkToc],
          rehypePlugins: [rehypeSlug],
          remarkRehype: true,
          gfm: true,
          smartypants: true,
        }),
        remarkPlugins: [remarkToc],
        rehypePlugins: [rehypeSlug],
        remarkRehype: true,
        gfm: true,
        smartypants: true,
      },
    });

    For more information on enabling and using this feature in your project, see our Markdown guide. To give feedback on this new Rust processor, see the Native Markdown / MDX parsing and processing RFC.

  🍿 Minor Changes

  • #16848 f732f3c Thanks @Princesseuh! - Adds support for using @astrojs/markdown-satteri to parse .mdx files.

    import { defineConfig } from 'astro/config';
    import mdx from '@astrojs/mdx';
    import { satteri } from '@astrojs/markdown-satteri';
    
    export default defineConfig({
      markdown: {
        processor: satteri({
          features: { directive: true },
        }),
      },
      integrations: [mdx()],
    });

    Note that the recmaPlugins option is not supported when using Sätteri as your MDX processor. If you would like to use Sätteri for Markdown files, but still use Unified for MDX, you can pass a different Markdown processor to the MDX integration:

    import { defineConfig } from 'astro/config';
    import mdx from '@astrojs/mdx';
    import { satteri } from '@astrojs/markdown-satteri';
    import { unified } from '@astrojs/markdown-remark';
    import myPlugin from './my-recma-plugin.js';
    
    export default defineConfig({
      markdown: {
        processor: satteri({
          features: { directive: true },
        }),
      },
      integrations: [
        mdx({
          recmaPlugins: [myPlugin],
          processor: unified(),
        }),
      ],
    });

  🐞 Patch Changes

  • Updated dependencies [f732f3c, f732f3c, f732f3c]:
    • @astrojs/internal-helpers@0.10.0
    • @astrojs/markdown-remark@7.2.0
    • @astrojs/markdown-satteri@0.2.0
• 5.0.6

  May 14, 2026

  🐞 Patch Changes

  • #16579 49e10e3 Thanks @igor-koop! - Fixes an issue where the smartypants option was ignored.
• 5.0.5

  May 13, 2026

  🐞 Patch Changes

  • Updated dependencies [9256345]:
    • @astrojs/markdown-remark@7.1.2
• 6.0.0-alpha.0

  Apr 30, 2026

  ✨ Major Changes

  • #15819 cafec4e Thanks @delucis! - Upgrade to Vite v8

  🐞 Patch Changes

  • Updated dependencies [cafec4e, cafec4e, c30a778, ee079d4]:
    • astro@7.0.0-alpha.0
• 5.0.4

  Apr 22, 2026

  🐞 Patch Changes

  • Updated dependencies [f3485c3]:
    • @astrojs/markdown-remark@7.1.1
• 5.0.3

  Mar 26, 2026

  🐞 Patch Changes

  • Updated dependencies [10a1a5a]:
    • @astrojs/markdown-remark@7.1.0
• 5.0.2

  Mar 18, 2026

  🐞 Patch Changes

  • #15864 d3c7de9 Thanks @florian-lefebvre! - Removes temporary support for Node >=20.19.1 because Stackblitz now uses Node 22 by default

  • Updated dependencies []:

    • @astrojs/markdown-remark@7.0.1
• 5.0.1

  Mar 16, 2026

  🐞 Patch Changes

  • #15934 6f8f0bc Thanks @ematipico! - Updates the Astro peerDependencies#astro to be 6.0.0.
• 4.3.14

  Mar 10, 2026

  🐞 Patch Changes

  • Updated dependencies []:
    • @astrojs/markdown-remark@6.3.11
• 5.0.0

  Mar 10, 2026

  ✨ Major Changes

  • #14494 727b0a2 Thanks @florian-lefebvre! - Updates Markdown heading ID generation - (v6 upgrade guidance)

  • #14427 e131261 Thanks @florian-lefebvre! - Increases minimum Node.js version to 22.12.0 - (v6 upgrade guidance)

  • #14445 ecb0b98 Thanks @florian-lefebvre! - Astro v6.0 upgrades to Vite v7.0 as the development server and production bundler - (v6 upgrade guidance)

  🐞 Patch Changes

  • #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

  • #15475 36fc0e0 Thanks @delucis! - Fixes edge cases where an export const components = {...} declaration would fail to be detected with the optimize option enabled

  • #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

  • Updated dependencies [bbb5811, cb99214, 80f0225, 727b0a2, 1fa4177, 7c55f80, 6f19ecc, f94d3c5]:

    • @astrojs/markdown-remark@7.0.0
• 5.0.0-beta.12

  Mar 6, 2026

  🐞 Patch Changes

  • Updated dependencies []:
    • @astrojs/markdown-remark@7.0.0-beta.11
• 5.0.0-beta.11

  Mar 5, 2026

  🐞 Patch Changes

  • Updated dependencies []:
    • @astrojs/markdown-remark@7.0.0-beta.10
• 5.0.0-beta.10

  Mar 4, 2026

  🐞 Patch Changes

  • Updated dependencies [6f19ecc, f94d3c5]:
    • @astrojs/markdown-remark@7.0.0-beta.9
• 5.0.0-beta.9

  Feb 26, 2026

  🐞 Patch Changes

  • Updated dependencies [1fa4177]:
    • @astrojs/markdown-remark@7.0.0-beta.8
• 5.0.0-beta.8

  Feb 17, 2026

  ✨ Major Changes

  • #15451 84d6efd Thanks @ematipico! - Changes how styles applied to code blocks are emitted to support CSP - (v6 upgrade guidance)

  🐞 Patch Changes

  • Updated dependencies [84d6efd]:
    • @astrojs/markdown-remark@7.0.0-beta.7
• 5.0.0-beta.7

  Feb 11, 2026

  🐞 Patch Changes

  • #15475 36fc0e0 Thanks @delucis! - Fixes edge cases where an export const components = {...} declaration would fail to be detected with the optimize option enabled
• 5.0.0-beta.6

  Feb 9, 2026

  🐞 Patch Changes

  • Updated dependencies []:
    • @astrojs/markdown-remark@7.0.0-beta.6
• 5.0.0-beta.5

  Feb 5, 2026

  🐞 Patch Changes

  • Updated dependencies [80f0225]:
    • @astrojs/markdown-remark@7.0.0-beta.5
• 5.0.0-beta.4

  Feb 4, 2026

  🐞 Patch Changes

  • Updated dependencies []:
    • @astrojs/markdown-remark@7.0.0-beta.4