Markdown文档翻译工具
翻译 Markdown 与 MDX 文档,代码与链接原封不动
上传 .md 或 .mdx 文件,或将整个文档目录打包为 .zip 上传,选择目标语言,即可下载翻译完毕的同结构目录。代码块、行内代码、链接与图片地址、front matter 键、MDX import 和组件完全保持原样;标题、段落、列表、表格、图片 alt 文本以及 front matter 中的标题与描述均会精准翻译。无需注册,前段免费体验;完整文档目录(上限 1,000,000 字符)只需一次付费 $5。普通 AI聊天机器人 翻译单个 README 尚可,但若处理包含数十个文件的文档站点,往往会误翻代码、破坏链接并改乱 front matter。
你将收到的文件
单个文件在导出时会按语言代码重命名(例如 README.md 变为 README.de.md)。文件夹则会打包为 .zip 导出,以目标语言命名的根目录下保留全部原有相对路径(例如 docs-de/),可直接拷入 i18n/de 或站点的语言目录中。下载前,系统会在屏幕上将每段译文及其 Markdown 标记与原文对照呈现,你还可以直接在线编辑。
- 标题会保留自定义锚点(如 {#install});列表保留标记符号与缩进;表格保留竖线与对齐行。
- 链接:仅翻译链接文本,链接地址和标题保持不变;诸如 [docs]: https://… 的引用定义完全保留原样。
- Front matter:仅翻译 title、description、summary、sidebar_label 等文本字段;slug、日期、tags、id 及所有键名均原样保留。
- MDX:import 和 export 语句、JSX 组件代码行及 {expressions} 均按原样保留。
普通 AI聊天机器人 翻译文档 vs 本工具
AI聊天机器人 通常能很好地翻译单个 README。但文档站点往往由数十个文件组成,充斥着各种绝对不能篡改的代码语法,而聊天助手全篇重写时对此毫无校验能力。
| 场景 | 普通 AI聊天机器人 | 本工具 |
|---|---|---|
| 单个较短的 README | 通常能顺利翻译 | 翻译精准,Markdown 语法完全无损 |
| 包含 60 个文件的文档目录 | 只能手动逐个文件复制粘贴;长文件容易中途截断 | 一次任务处理整个 .zip 包,保持原目录路径导出 |
| 代码块与行内代码 | 经常误翻译注释、变量名或命令行指令 | 根本不传给翻译模型;逐字节原样保留 |
| 链接与图片 | 可能会误翻译或改写相对路径及锚点 | 链接地址对模型屏蔽,翻译后原样还原 |
| 前置元数据 | 可能误翻译 slug 或 id 等键名 | 仅翻译 title、description 等文本字段 |
| MDX 组件 | 可能会篡改 JSX 标签或 props 属性 | Import、export 及组件代码行原样保留 |
如何翻译 Markdown 文档目录
-
1
上传文件或 .zip 包并选择语言
拖入 .md、.mdx 或 .markdown 文件,或将整个文档目录压缩为 .zip 上传。选择目标语言,可填入需要保留的产品名称与专业术语。
-
2
免费查看前段预览
屏幕上会展示前几个文本块与原文的对照译文。可直接在线修改,无需注册。
-
3
解锁完整结果并下载
仅需 $5 即可解锁完整任务,下载包含翻译后文件夹的 .zip 包,并附带可能需要检查的提示清单。
为什么通用 AI 助手处理文档容易出错
Markdown 将自然语言文本与非文本元素紧密交织在一起:代码、命令行、路径、锚点、YAML 键值以及 MDX 中的 JavaScript。如果让 AI 助手直接重写整个文件,它必须在翻译文字的同时逐一精确复制这些非文本代码;面对一个接一个的文件,一旦它误改了某条命令或链接路径,你很难第一时间察觉。
本工具采用逐行解析机制:完全跳过代码块、MDX import 语句及组件代码行;在将内容发给模型前,自动将行内代码、链接地址、图片路径和 {expressions} 替换为短标记。只有标题、段落、列表项、表格单元格、alt 文本和 front matter 文本字段会被分块提交翻译,并带上文件名作为上下文;翻译返回后严格校验所有标记是否完好,最后基于原有行结构重新组装文件。
常见适用场景
- Docusaurus、VitePress、MkDocs、Hugo 和 Astro 文档站点
- GitHub README、CONTRIBUTING 贡献指南以及导出为 Markdown 的 Wiki
- 从 Obsidian 或 Notion 导出的 Markdown 笔记
- 以 .md 文件管理的博客文章与知识库
- 用 Markdown 编写的课程教材与电子书
注意事项与限制说明
Front matter 中仅翻译纯文本字段(title、description、summary、excerpt、sidebar_label 等);多行 YAML 值和列表保持原样。原生 HTML 块在保留标签的前提下进行翻译。为防止语法损坏,代码中的注释默认绝不翻译。若 .zip 包中包含非 Markdown 文件,将原样复制保留。
一次付费支持单个 .zip 压缩包或最多 50 个文件,字符上限为 1,000,000 字符(约 300 页);无限版 支持上限至 2,000,000 字符。发布前建议复核译文,尤其是专有产品名词;通过配置术语表可确保术语前后一致。
按语言和场景
价格方案
小型任务 / 前段预览
免费
最多 40 个段落完全免费,支持直接下载。更长任务前段免费预览,无需注册。
完整任务
$5
文档目录压缩包或最多 50 个文件一次付费,上限 1,000,000 字符。无需订阅。
无限版
$19 / 周
畅用站内所有工具,单次任务支持高达 2,000,000 字符。
常见问题
ChatGPT 翻译 Markdown 文件时能保证不破坏格式吗?
翻译单篇短文档时通常可以。但面对整个文档文件夹时,它不仅慢、长文件容易中途截断,而且无法确保代码、链接和 front matter 键名完好无损。本工具绝不将代码或地址发送去翻译,并完全基于您的原始文件重新构建。
代码块会被翻译吗?
不会。围栏代码块(fenced code blocks)、行内代码和缩进代码均原样保留,其中的注释也不会被翻译。
支持 MDX 吗?
支持。import 和 export 代码行、纯 JSX 组件行以及 {expressions} 均原样保留,仅翻译其中的正文文本。
Front matter 会怎么处理?
title、description、summary 和 sidebar_label 等文本字段会被翻译。键名、slug、日期、标签、id 等其他值保持原样。
我可以上传整个文件夹吗?
可以。将文件夹压缩为 .zip 后上传即可。下载的结果也是一个 .zip 文件,所有文件按原路径保存在以目标语言命名的文件夹下;图片及其他非文本文件原样复制保留。
$5 能翻译多少内容?
单个任务最多可翻译 1,000,000 个字符(约 300 页):支持上传一个 .zip 压缩包或最多 50 个文件,单个文件最大 100 MB。代码及 front matter 键名均不计入字符数。
这项服务免费吗?
每个任务的前段免费翻译并直接在屏幕上展示。不超过 40 个段落的小任务完全免费,包含下载。更大的任务只需 $5,一次付费。
我的文件安全私密吗?
只有您本人可以查看您的任务。文本仅发送给 AI 模型服务商用于翻译,绝不会被用于模型训练。无需注册上传的任务将在 7 天后删除,您也可以随时手动删除任务。
更新于 2026年10月25日 · APPFACT STUDIO LTD