@next/mdx dependencies

[Valentin-Rault]

Summary

I am confused by the mdx packages needed to use with @next/mdx. It is showed in the documentation that @mdx-js/react should be installed. But when going to the mdxjs (https://mdxjs.com/packages/react/). There it specifically says to not use this package in a nextjs app. Which one is the correct one?

Additional information

No response

Example

No response

[lewiii254]

This is confusing because the MDX docs and the Next.js docs are talking about different use-cases.

The correct dependency for Next.js MDX is:

@mdx-js/react

Next.js does not provide its own MDX runtime. When you use @next/mdx, you still need @mdx-js/react so React can render MDX components at runtime.

Why the MDX site says “don’t use this in Next.js”

That warning refers to Next.js’ old MDX integration (before /app and before @next/mdx). In those older setups, MDX was precompiled via remark/rehype and did not need a runtime provider.

Today, with the official @next/mdx plugin, you do use the runtime — exactly like the docs show.

TL;DR

• Next.js 15/16 + @next/mdx → install @mdx-js/react
• The warning on mdxjs.com is about the old Next.js MDX plugin, not the current one.