npm / @astrojs/markdown-remark
@astrojs/markdown-remark
What changed in @astrojs/markdown-remark 6 to 7, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
3 breaking1 security8 deprecations4 new APIs and options2 performance3 behavior and defaults1 tooling3 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@astrojs/markdown-remark 724 changes
Breaking changes 2
Dynamic values passed as <script> or <style> children are escaped instead of rendered raw; use set:html to opt back into raw rendering.
Markdown heading ID generation is updated, which may change the IDs generated for headings.
Security 1
Nested object and package metadata lookups now ignore prototype keys in content handling and project scaffolding.
Deprecations 8
The top-level option is deprecated; move it onto unified({...}) or your preferred plugin processor.
The top-level option is deprecated; move plugins onto unified({...}) or your preferred plugin processor.
The top-level option is deprecated; move plugins onto unified({...}) or your preferred plugin processor.
The top-level option is deprecated; move it onto unified({...}) or your preferred plugin processor.
The top-level option is deprecated; move it onto unified({...}) or your preferred plugin processor.
The rehypePlugins option on the MDX integration is deprecated; move it onto unified({...}) or your preferred plugin processor.
The remarkPlugins option on the MDX integration is deprecated; move it onto unified({...}) or your preferred plugin processor.
The remarkRehype option on the MDX integration is deprecated; move it onto unified({...}) or your preferred plugin processor.
New APIs and options 4
Adds the recmaPlugins option for adding recma (estree/JSX) plugins to the MDX compiler.
Adds a configuration option for choosing an alternative Markdown processor; the default remains unified().
The smartypants property now accepts Smartypants options for fine-grained control over typography transformations.
Exposes the fileURL option so callers can specify the file URL used to resolve relative image paths.
Performance 2
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.
Cached Shiki highlighter instances are reused across languages.
Behavior and default changes 3
YAML parsing now supports timestamps and merge keys, and YAML errors are formatted consistently across Astro, Markdown, MDX, and Markdoc.
The processor now compiles .mdx files itself; projects still need to install @astrojs/mdx to add MDX support.
The processor now compiles .mdx files itself; projects still need to install @astrojs/mdx to add MDX support.
Tooling 1
The timing report now includes measurements for Markdown processing and syntax highlighting.
Fixes and other changes 3
Fixes highlighting for code block languages ending in a symbol, such as c#, c++, and f#.
Fixes an unexpected error caused by using the Code component.
Fixes Prism-generated code blocks incorrectly including the is:raw attribute in the final output.
@astrojs/markdown-remark 61 changes
Breaking changes 1
HAST-only props are no longer directly converted into HTML attributes.