# @astrojs/mdx

> Add support for MDX pages in your Astro site

Latest version **8.0.1** (published 2026-09-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install @astrojs/mdx
pnpm add @astrojs/mdx
yarn add @astrojs/mdx
bun add @astrojs/mdx
```

## Health

**Score 75/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo; extremely popular.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 8.0.1 |
| Published | 2026-09-08 |
| First published | 2022-06-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22.12.0 |
| Dependencies | 3 |
| Unpacked size | 29.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 62627 |
| Author | withastro |
| Maintainers | fredkschott, matthewp |
| Keywords | astro-integration, astro-component, mdx |

## Links

- npm: https://www.npmjs.com/package/@astrojs/mdx
- Repository: https://github.com/withastro/astro
- Homepage: https://docs.astro.build/en/guides/integrations-guide/mdx/
- Issues: https://github.com/withastro/astro/issues
- npm.io page: https://npm.io/package/@astrojs/mdx

## Dependencies (3)

- [es-module-lexer](https://npm.io/package/es-module-lexer.md) ^2.0.0
- [@astrojs/internal-helpers](https://npm.io/package/@astrojs/internal-helpers.md) 0.11.0
- [@astrojs/markdown-satteri](https://npm.io/package/@astrojs/markdown-satteri.md) 0.4.1

## Alternatives

- [@mdxeditor/editor](https://npm.io/package/@mdxeditor/editor.md) — 962.4K weekly downloads
- [mmdb-lib](https://npm.io/package/mmdb-lib.md) — 680.9K weekly downloads
- [playcanvas](https://npm.io/package/playcanvas.md) — 36.2K weekly downloads
- [@glw907/cairn-cms](https://npm.io/package/@glw907/cairn-cms.md) — 967 weekly downloads
- [markdown-to-confluence](https://npm.io/package/markdown-to-confluence.md) — 103 weekly downloads

## Recent versions

- 8.0.1 (latest) — 2026-09-08
- 7.0.0-beta.4 (beta) — 2026-06-19
- 6.0.0-alpha.1 (alpha) — 2026-06-08
- 0.0.0-router-noexec-20250129135648 (experimental--router-noexec) — 2025-01-29
- 0.0.0-middleware-fix-20241210163342 (experimental--middleware-fix) — 2024-12-10
- 0.0.0-routemanifest-refactor-20241209145150 (experimental--routemanifest-refactor) — 2024-12-09
- 0.0.0-svg-leak-20241209134543 (experimental--svg-leak) — 2024-12-09
- 0.0.0-astroenv-dev-20241206160513 (experimental--astroenv-dev) — 2024-12-06
- 0.0.0-process-env-override-20241206130809 (experimental--process-env-override) — 2024-12-06
- 0.0.0-sessions-20241205174618 (experimental--sessions) — 2024-12-05
- 0.0.0-mdx-layout-style-20240822115312 (experimental--mdx-layout-style) — 2024-08-22
- 0.0.0-server-islands-20240718131003 (experimental--server-islands) — 2024-07-18
- 0.0.0-noSync-20240718092432 (experimental--noSync) — 2024-07-18
- 0.0.0-container-20240524172326 (experimental--container) — 2024-05-24
- 0.0.0-astro-env-20240508155554 (experimental--astro-env) — 2024-05-08
- … 250 more at https://npm.io/package/@astrojs/mdx/versions

## README

# @astrojs/mdx 📝

This **[Astro integration][astro-integration]** enables the usage of [MDX](https://mdxjs.com/) components and allows you to create pages as `.mdx` files.

## Documentation

Read the [`@astrojs/mdx` docs][docs]

## Support

- Get help in the [Astro Discord][discord]. Post questions in our `#support` forum, or visit our dedicated `#dev` channel to discuss current development and more!

- Check our [Astro Integration Documentation][astro-integration] for more on integrations.

- Submit bug reports and feature requests as [GitHub issues][issues].

## Contributing

This package is maintained by Astro's Core team. You're welcome to submit an issue or PR! These links will help you get started:

- [Contributor Manual][contributing]
- [Code of Conduct][coc]
- [Community Guide][community]

## License

MIT

Copyright (c) 2023–present [Astro][astro]

[astro]: https://astro.build/
[docs]: https://docs.astro.build/en/guides/integrations-guide/mdx/
[contributing]: https://github.com/withastro/astro/blob/main/CONTRIBUTING.md
[coc]: https://github.com/withastro/.github/blob/main/CODE_OF_CONDUCT.md
[community]: https://github.com/withastro/.github/blob/main/COMMUNITY_GUIDE.md
[discord]: https://astro.build/chat/
[issues]: https://github.com/withastro/astro/issues
[astro-integration]: https://docs.astro.build/en/guides/integrations/

---
_Source: https://npm.io/package/@astrojs/mdx · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._