翻译 Markdown 和 MDX 文档
文档不是键的列表。其文本散布在代码块、链接和 front matter 中，这些内容必须精确地恢复。KAERIS 将文件分割成受保护的片段和散文，仅翻译散文，然后将片段重新组合。
KAERIS 翻译了此页面，并通过回译检查了每一行。尚未经过母语人士审阅。 英文原文
Markdown 文档是如何读取的
文档被分割成文字片段的骨架和编号的文本段。在段落内部，行内代码、链接目标、HTML 和 JSX 标签会被替换为像 {0} 这样的标记，然后在翻译后恢复。遗漏了标记的模型会触发与遗漏变量相同的检测器。
--- title: Getting started slug: getting-started --- # Getting started Install the package with `pip install kaeris`, then read the [CLI guide](/docs/cli). ```bash kaeris translate en.json --langs de,ja ``` Run it once per release. It only translates new keys.
Markdown 翻译中需要注意的事项
代码不是散文
翻译后的代码块仍然可以渲染，但对于复制它的读者来说会失败。带围栏的代码、缩进的代码、行内代码以及 MDX 的
import/export行永远不会被翻译。链接
链接文本会被翻译；链接目标不会。翻译后的 URL 仍然看起来像一个链接，但会返回 404。
Front matter
像
slug、date、layout和tags这样的设置会保持不变。读者看到的字段，如title和summary，会被翻译。一个已知限制
多行 JSX 组件内的文本将被完整保留，不会被翻译。此页面的读者会在此处被告知，而不是在构建之后。
真实运行，之前和之后
真实运行：我们的测试文档，德语，26 October 2026，截取为开头和一个代码块。标题、粗体文本、curl 命令和 $TOKEN 标记与源文件相同；只有散文和读者看到的 front-matter 字段发生了变化。
---
title: Returns and refunds
summary: How to return a record, and when you will not get a refund.
---
# Returns and refunds
You can return an unopened record within **30 days** of delivery. We refund the full price, but not the shipping cost.
…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```
---
title: Rücksendungen und Erstattungen
summary: So senden Sie eine Schallplatte zurück und wann Sie keine Erstattung erhalten.
---
# Rücksendungen und Erstattungen
Sie können eine ungeöffnete Schallplatte innerhalb von **30 Tagen** nach Lieferung zurücksenden. Wir erstatten den vollen Preis, jedoch nicht die Versandkosten.
…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```
KAERIS 的处理方式
骨架和散文分开处理
标题、表格、列表和围栏保持其形状；只有其中的散文被替换。
每个语言一个输出
guide.md会变成de.md、ja.md等。每行都翻译回来
--verify会将结果翻译回来并写入verify.json，以便您可以阅读每个部分现在的内容。
分三步运行
安装 CLI
运行
pip install kaeris。翻译文档
运行
kaeris translate docs/guide.md --langs de,ja。像docs/*.md这样的 glob 会翻译多个文件。读回内容
打开
--verify运行生成的verify.json文件，查看每个翻译部分现在用您的语言说的是什么。
pip install kaeris kaeris translate docs/guide.md --langs de,ja --verify
问题
我的文档中的代码会被翻译吗？
不会。代码块（包括用围栏标记和缩进的代码块）、行内代码、URL、HTML 和 JSX 标签会按原样返回。
它会翻译 MDX 组件吗？
是的，会翻译文本内容以及其周围的单行部分。多行 JSX 组件内的文本会被保留而不是翻译，这是格式读取器的限制。
免费吗？
是的，无需账户：每个文件 10,000 个字符，每次运行最多 8 种语言。免费的 API 密钥可将文件限制提高到 50,000 个字符。一次性付费 79 美元，使用您自己的 OpenRouter 密钥；月度套餐起价为 19 美元。价格
我可以在终端或 CI 中运行它吗？
是的。运行 pip install kaeris，然后运行 kaeris translate docs/guide.md --langs de,ja。GitHub Action 会在拉取请求中运行相同的翻译。 CLI 文档 · GitHub Action
继续
CLI 参考 · 检查参考 · 在浏览器中翻译 · 免费检查 · 格式转换 · 伪本地化
其他格式： JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · CSV · Fluent · Android XML