# @docusaurus/mdx-loader

> Docusaurus Loader for MDX

Latest version **3.10.2** (published 2026-07-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @docusaurus/mdx-loader
pnpm add @docusaurus/mdx-loader
yarn add @docusaurus/mdx-loader
bun add @docusaurus/mdx-loader
```

## Health

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

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

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 3.10.2 |
| Published | 2026-07-10 |
| First published | 2019-04-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=20.0 |
| Dependencies | 24 |
| Unpacked size | 252.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 66262 |
| Maintainers | fb, slorber, lex111, docusaurus-bot |

## Links

- npm: https://www.npmjs.com/package/@docusaurus/mdx-loader
- Repository: https://github.com/facebook/docusaurus
- Homepage: https://github.com/facebook/docusaurus#readme
- Issues: https://github.com/facebook/docusaurus/issues
- npm.io page: https://npm.io/package/@docusaurus/mdx-loader

## Dependencies (24)

- [tslib](https://npm.io/package/tslib.md) ^2.6.0
- [vfile](https://npm.io/package/vfile.md) ^6.0.1
- [unified](https://npm.io/package/unified.md) ^11.0.3
- [webpack](https://npm.io/package/webpack.md) ^5.88.1
- [fs-extra](https://npm.io/package/fs-extra.md) ^11.1.1
- [image-size](https://npm.io/package/image-size.md) ^2.0.2
- [rehype-raw](https://npm.io/package/rehype-raw.md) ^7.0.0
- [remark-gfm](https://npm.io/package/remark-gfm.md) ^4.0.0
- [url-loader](https://npm.io/package/url-loader.md) ^4.1.1
- [@mdx-js/mdx](https://npm.io/package/@mdx-js/mdx.md) ^3.0.0
- [escape-html](https://npm.io/package/escape-html.md) ^1.0.3
- [file-loader](https://npm.io/package/file-loader.md) ^6.2.0
- [remark-emoji](https://npm.io/package/remark-emoji.md) ^4.0.0
- [mdast-util-mdx](https://npm.io/package/mdast-util-mdx.md) ^3.0.0
- [remark-directive](https://npm.io/package/remark-directive.md) ^3.0.0
- [stringify-object](https://npm.io/package/stringify-object.md) ^3.3.0
- [unist-util-visit](https://npm.io/package/unist-util-visit.md) ^5.0.0
- [@docusaurus/utils](https://npm.io/package/@docusaurus/utils.md) 3.10.2
- [@docusaurus/logger](https://npm.io/package/@docusaurus/logger.md) 3.10.2
- [remark-frontmatter](https://npm.io/package/remark-frontmatter.md) ^5.0.0
- [mdast-util-to-string](https://npm.io/package/mdast-util-to-string.md) ^4.0.0
- [@slorber/remark-comment](https://npm.io/package/@slorber/remark-comment.md) ^1.0.0
- [estree-util-value-to-estree](https://npm.io/package/estree-util-value-to-estree.md) ^3.0.1
- [@docusaurus/utils-validation](https://npm.io/package/@docusaurus/utils-validation.md) 3.10.2

## Recent versions

- 3.10.2 (latest) — 2026-07-10
- 4.0.0-canary-6821 (canary) — 2026-09-18
- 3.9.2-alpha.4 (alpha) — 2026-03-20
- 3.0.0-rc.1 (next) — 2023-10-26
- 4.0.0-canary-6820 — 2026-09-18
- 4.0.0-canary-6818 — 2026-09-18
- 4.0.0-canary-6817 — 2026-09-18
- 4.0.0-canary-6816 — 2026-09-18
- 4.0.0-canary-6815 — 2026-09-18
- 4.0.0-canary-6814 — 2026-09-17
- 4.0.0-canary-6813 — 2026-09-17
- 4.0.0-canary-6811 — 2026-09-17
- 4.0.0-canary-6810 — 2026-09-17
- 4.0.0-canary-6809 — 2026-09-17
- 4.0.0-canary-6808 — 2026-09-14
- … 2123 more at https://npm.io/package/@docusaurus/mdx-loader/versions

## README

# `@docusaurus/mdx-loader`

Docusaurus webpack loader for [MDX](https://github.com/mdx-js/mdx).

## Installation

```sh
yarn add @docusaurus/mdx-loader
```

## Usage

```js
// ...
module: {
  rules: [
    // ...
    {
      test: /\.mdx?$/,
      use: [
        {
          loader: '@docusaurus/mdx-loader',
          options: {
            // .. See options
          },
        },
      ],
    },
  ];
}
```

## Options

### `rehypePlugins`

Array of rehype plugins to manipulate the MDXHAST

### `remarkPlugins`

Array of remark plugins to manipulate the MDXAST

### `metadataPath`

A function to provide the metadataPath depending on current loaded MDX path that will be exported as the MDX metadata.

### `markdownConfig`

The global Docusaurus Markdown config (`config.markdown`), that plugin authors should forward:

```js
const loader = {
  loader: require.resolve('@docusaurus/mdx-loader'),
  options: {
    markdownConfig: siteConfig.markdown,
  },
};
```

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