翻译 Docusaurus 文档，保持 MDX 与代码结构不变
将 docs 文件夹压缩打包上传，即可获得已翻译好的完整文件，可直接放入 i18n/<locale>/docusaurus-plugin-content-docs/current。import 代码行、Tabs 等组件、提示框标记、代码块及链接原样保留；标题、侧边栏标签（sidebar_label）、描述和正文完成翻译。无需注册，前段免费；最多 1,000,000 字符正文仅需 $5（一次付费）。
告别繁琐复制粘贴，轻松搞定 Docusaurus i18n
Docusaurus 要求在对应语言目录下保留每篇文档的同名翻译副本。手动复制或在 AI 聊天机器人中逐个文件翻译不仅耗时，而且 MDX 容错率极低：译错一个 import 名称或改动一个 prop 就会导致构建失败。本工具仅翻译读者可见的正文内容，其余结构代码原样从源文件复制。
行内代码、链接目标、图片路径和 MDX {expressions} 在翻译前都会被替换为占位标记并在译后还原，模型完全不会接触到它们。纯 JSX 代码行（如 <Tabs> 或 <TabItem value="mac">）直接跳过。代码块全量跳过，包含其中的注释。
下载后操作步骤
- 解压并将 docs-<locale> 文件夹中的内容复制到 i18n/<locale>/docusaurus-plugin-content-docs/current
- 运行 docusaurus write-translations 提取主题标签与侧边栏分类名称（存储于 JSON 中）
- 使用 --locale <locale> 启动本地站点并浏览检查
- 若生成了警告文件，对照修正其中列出的段落
不包含的内容
侧边栏分类标签、导航栏和页脚文本位于 write-translations 生成的 JSON 文件中；请使用本地化文件翻译工具进行处理。博客文章的处理方式与文档相同：将 blog 目录打包作为单独任务上传，或与 docs 一起打包为单个 .zip 上传。
工具的工作方式、费用以及文件处理方式,请见 Markdown文档翻译 页面;所有工具的价格请见 价格 页面。
最后更新于
常见问题
构建能正常通过吗？
Imports、组件、props、代码块和链接目标均直接从源文件原样复制，而这些正是 MDX 构建中最常出错的地方。复制文件后运行一次构建，并留意查看警告文件即可。
提示框（admonitions）会被翻译吗？
:::note 和 ::: 标记行原样保留，仅翻译标记之间的文本内容。
单个任务的容量上限是多少？
单个任务仅需 $5，最多支持 1,000,000 字符正文，约合 300 页。代码块与 front matter 键名不计入字数。
可以先试用几个文件吗？
可以。前段会免费翻译并直接在页面上预览展示；若任务总计不超过 40 个段落，则完全免费。