# What changed in eslint-plugin-mdx

> 15 changes in eslint-plugin-mdx 2 to 3 from its official release notes, upgrade guides and advisories: 5 breaking. Each one cited. Sources checked 2026-10-25. HTML: https://unstale.sh/npm/eslint-plugin-mdx/

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

## eslint-plugin-mdx 3

### Breaking changes

- The plugin supports MDX v3. (3.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v3.0.0)
- Node.js 18 or later is required; Node.js 12, 14, and 16 are no longer supported. (3.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v3.0.0)

### Behavior and default changes

- Premade configs now set ecmaFeatures.jsx to true, enabling JSX parsing. (3.8.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/eslint-plugin-mdx%403.8.0)

### Tooling

- Adds support for eslint 10. (3.7.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/eslint-plugin-mdx%403.7.0)

### Fixes and other changes

- Support the ESLint config inspector. (3.8.1) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/eslint-plugin-mdx%403.8.1)

## eslint-plugin-mdx 2

### Breaking changes

- Drops support for ESLint versions below 8. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)
- Drops support for Node versions below 12.20. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)
- Drops support for the parser option; use ESLint config overrides instead. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)

### Performance

- Uses the same cached markdown processor for .md and .mdx files. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)

### Behavior and default changes

- Adds experimental support for remark-mdx 2. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)

### Fixes and other changes

- Errors are reported with the correct location. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)
- Error output is sorted by line and column. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)
- Restores the first-level JSX AST and tokens. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)
- Fixes an issue involving Node.js ES modules and workers on Windows. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)
- Handles nodes and children recursively. (2.0.0) — [release notes](https://github.com/mdx-js/eslint-mdx/releases/tag/v2.0.0)