# What changed in @astrojs/markdown-remark

> 25 changes in @astrojs/markdown-remark 6 to 7 from its official release notes, upgrade guides and advisories: 3 breaking, 8 deprecations, 1 security, 4 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@astrojs/markdown-remark/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @astrojs/markdown-remark 7

### Breaking changes

- Dynamic values passed as <script> or <style> children are escaped instead of rendered raw; use set:html to opt back into raw rendering. (7.3.1) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.3.1)
- Markdown heading ID generation is updated, which may change the IDs generated for headings. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.0.0)

### Security

- Nested object and package metadata lookups now ignore prototype keys in content handling and project scaffolding. (7.1.1) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.1.1)

### Deprecations

- The top-level option is deprecated; move it onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The top-level option is deprecated; move plugins onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The top-level option is deprecated; move plugins onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The top-level option is deprecated; move it onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The top-level option is deprecated; move it onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The rehypePlugins option on the MDX integration is deprecated; move it onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The remarkPlugins option on the MDX integration is deprecated; move it onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The remarkRehype option on the MDX integration is deprecated; move it onto unified({...}) or your preferred plugin processor. (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)

### New APIs and options

- Adds the recmaPlugins option for adding recma (estree/JSX) plugins to the MDX compiler. (7.3.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.3.0)
- Adds a configuration option for choosing an alternative Markdown processor; the default remains unified(). (7.2.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.2.0)
- The smartypants property now accepts Smartypants options for fine-grained control over typography transformations. (7.1.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.1.0)
- Exposes the fileURL option so callers can specify the file URL used to resolve relative image paths. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.0.0)

### Performance

- Returns a cached highlighter based on Shiki options instead of always creating a new instance, improving performance for sites that heavily use Shiki and code. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.0.0)
- Cached Shiki highlighter instances are reused across languages. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.0.0)

### Behavior and default changes

- YAML parsing now supports timestamps and merge keys, and YAML errors are formatted consistently across Astro, Markdown, MDX, and Markdoc. (7.3.2) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.3.2)
- The processor now compiles .mdx files itself; projects still need to install @astrojs/mdx to add MDX support. (7.3.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.3.0)
- The processor now compiles .mdx files itself; projects still need to install @astrojs/mdx to add MDX support. (7.3.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.3.0)

### Tooling

- The timing report now includes measurements for Markdown processing and syntax highlighting. (7.3.3) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.3.3)

### Fixes and other changes

- Fixes highlighting for code block languages ending in a symbol, such as c#, c++, and f#. (7.3.2) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.3.2)
- Fixes an unexpected error caused by using the Code component. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.0.0)
- Fixes Prism-generated code blocks incorrectly including the is:raw attribute in the final output. (7.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%407.0.0)

## @astrojs/markdown-remark 6

### Breaking changes

- HAST-only props are no longer directly converted into HTML attributes. (6.3.10) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdown-remark%406.3.10)