# What changed in @astrojs/markdoc

> 14 changes in @astrojs/markdoc 1 to 2 from its official release notes, upgrade guides and advisories: 7 breaking, 1 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/npm/@astrojs/markdoc/

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

## @astrojs/markdoc 2

### Breaking changes

- Image handling is updated for Astro 7.4 and requires astro@^7.4.0. (2.1.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.1.0)
- The minimum supported Node.js version is now 22.22.0. (2.1.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.1.0)

### New APIs and options

- YAML parsing now supports timestamps and merge keys in Markdoc. (2.0.10) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.0.10)

### Fixes and other changes

- YAML errors are now formatted consistently across Astro, Markdown, MDX, and Markdoc. (2.0.10) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.0.10)
- User-written transforms are preserved when a tag or node also specifies a custom render component; only Markdoc’s built-in transforms are removed. (2.0.5) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.0.5)
- Custom transforms are no longer dropped for tag and node names requiring bracket access; detection recognizes bracket notation, optional chaining and whitespace. (2.0.5) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.0.5)
- Corrects the dependencies listed in the peerDependencies field. (2.0.2) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.0.2)
- Fixes a crash when rendering Shiki-highlighted code blocks inside list items. (2.0.1) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%402.0.1)

## @astrojs/markdoc 1

### Breaking changes

- Temporary support for Node >=20.19.1 was removed because Stackblitz now uses Node 22 by default. (1.0.2) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%401.0.2)
- Updates the Astro peer dependency to 6.0.0, affecting which Astro version is compatible with @astrojs/markdoc. (1.0.1) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%401.0.1)
- Markdown heading ID generation is updated, which may change the IDs generated for headings. (1.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%401.0.0)
- When a Markdoc node config specifies both render and transform, render now takes precedence over transform. (1.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%401.0.0)
- Astro v6 upgrades to Vite v7.0 for the development server and production bundler. (1.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%401.0.0)

### Fixes and other changes

- Custom attribute declarations are synced between same-named table tags and nodes, so defining them on either side avoids validation errors. (1.0.0) — [release notes](https://github.com/withastro/astro/releases/tag/%40astrojs/markdoc%401.0.0)