MDX v3 新特性与迁移要点

---

标题: MDX v3 新特性与迁移要点

关键词:

• MDX v3
• ES2024 支持
• await 语法
• Node 16+
• 迁移指南

描述: 总结 MDX v3 的关键更新（ES2024 与 await 支持、Node 版本要求）与迁移注意事项，并给出与文档站/框架的协作建议，附中文来源验证。

categories:

• 文章资讯
• 技术教程

---

引言

• MDX 作为 Markdown 与 JSX 的融合，在 v3 增量更新中强化了现代语法支持与运行要求，适合与 Docusaurus、Next.js、Vite 等协作。

核心更新（已验证）

• ES2024 支持：内部解析器（如 Acorn）按 ES2024 解析，允许在 MDX 中使用现代 JS 语法。来源：MDX 中文文档。
• await 语法：在框架也支持的前提下，MDX 中可使用 await。来源：MDX 中文文档。
• Node 要求：放弃旧版 Node，要求 Node 16 或更高。来源：MDX 中文文档与 v3 博文。

迁移要点

• 版本校验：升级至 v3 并验证 Node 版本；关注移除的弃用配置项。
• 框架协作：在 Next.js、Vite 等环境下测试构建链与渲染；文档站可结合 Rspress 的 mdx-rs 获得更高性能编译。

参考链接（验证来源）

• MDX 中文站：概览与 v3 更新：https://www.mdxjs.cn/
• MDX 中文站：v3 博文与迁移说明：https://www.mdxjs.cn/blog/v3/

结语

• MDX v3 聚焦“现代语法＋稳定要求”的增量升级；建议在文档站与博客项目中优先落地，并验证与构建工具的配合。