Markdown 翻译器
Markdown 是我日常使用最频繁的文本格式，但现有的翻译工具往往难以保持其原有格式。因此，我开发了 md-translator，一个专为 Markdown 优化的翻译工具，旨在 精准翻译文本的同时保持格式完整。
Markdown 元素支持
md-translator 目前已支持解析以下 Markdown 语法，并在翻译时保持格式：
- FrontMatter 元数据（---）
- 标题（#）
- 链接（[text](url)）
- 无序列表（- / * / +）
- 有序列表（1. 2. 3.）
- 加重字体（加粗，斜体）
- 代码块（```）
- 内联代码（`code`）
- 引用块（> 引用）
此外，md-translator 可提取纯文本内容，去除 Markdown 标记，同时隐藏链接和代码块等元素，以便用于其他用途。
翻译 API
本工具支持 5 种翻译 API 和 5 种 LLM（大语言模型）接口，用户可根据需求选择合适的翻译方式：
翻译 API 对比
| API 类型 | 翻译质量 | 稳定性 | 适用场景 | 免费额度 |
|---|---|---|---|---|
| DeepL(X) | ★★★★★ | ★★★★☆ | 适合长文本，翻译更流畅 | 每月 50 万字符 |
| Google Translate | ★★★★☆ | ★★★★★ | 适合 UI 界面、常见句子 | 每月 50 万字符 |
| Azure Translate | ★★★★☆ | ★★★★★ | 语言支持最广泛 | 前 12 个月 每月 200 万字符 |
| GTX API（免费） | ★★★☆☆ | ★★★☆☆ | 一般文本翻译 | 免费 |
| GTX Web（免费） | ★★★☆☆ | ★★☆☆☆ | 适合小规模翻译 | 免费 |
- DeepL：适用于长篇文本，翻译更加流畅自然，但不支持网页端 API，需本地或服务器代理调用。
- Google Translate：翻译质量稳定，适用于短句、界面文本，支持网页端调用。
- Azure Translate：支持语言最多，适合多语言翻译需求。
- GTX API/Web：免费翻译选项，适合小规模使用，但稳定性一般。
如果对翻译速度和质量有更高要求，可自行申请 API Key：Google Translate、Azure Translate、DeepL Translate。申请流程参考相关的接口申请教程。
LLM 翻译（AI 大模型）
本工具提供了 5 种主流 AI 大语言模型（LLM）或接口，分别为：OpenAI、DeepSeek、Siliconflow、Groq 以及 自定义模型（Custom LLM）。
- 适用场景：适合处理语言理解要求较高的内容，如文学作品、技术文档、多语种资料等。
- 可定制性：支持自定义系统提示词（System Prompt）与用户提示词（User Prompt），可灵活调整翻译风格和术语偏好，更好地满足不同使用场景的需求。
- 温度参数（temperature）：可控制翻译结果的随机性。数值越高，生成内容越具创意，但可能影响一致性与准确性。
自定义模型（Custom LLM）支持通过配置 API 接口和模型名称，接入第三方服务或本地推理平台（如 ollama）。例如，默认本地 ollama 的 API 地址为：
默认使用模型为 llama3.2。如使用 LM Studio，本地接口地址为：
为获得更优的翻译质量，推荐在自定义模型中使用 qwen2.5-14b-instruct 或性能更高的模型。
语言支持
在多语言翻译能力方面，Google、Azure 和 LLM（大语言模型）均支持上百种语言的互译，而 DeepL 目前仅支持 30 种主流语言。因此，从语言覆盖范围来看，DeepL 相对较弱。
具体的支持语言列表可参考以下官方文档：
API 参数
分块翻译大小
对于字幕、Markdown 等具有上下文关联的文本文件，本工具会将多行文本自动合并为若干“块”进行翻译。分块翻译大小即指每个打包块的字符数上限。不同翻译服务的最大字符限制如下：
- DeepL API：每个请求最多支持 128K 个字符。
- DeepLX Free：每个请求最多支持 1,000 个字符。
- Azure Translate：每个请求最多支持 10,000 个字符。
- Google Translate：
- 网页端：每次翻译最多支持 5,000 个字符；
- Cloud Translation API：每个请求最多支持 30,000 个字符。
注意：由于 Google 翻译在处理文本时会破坏换行符，因此未使用分块翻译方式。
延迟时间
延迟时间用于设置分块翻译之间的等待间隔。在处理大段文本时，某些翻译 API 响应速度较慢，尤其在网络环境较差或使用免费接口的情况下，延迟设置显得尤为重要。
例如，在使用 Azure Translate 的免费端口进行测试时，建议将延迟时间设置为 5,000 毫秒以上，以避免返回空值或出错。
翻译速率
翻译速率设置过高可能导致 API 返回空值，甚至被视为异常请求。建议根据实际使用的服务类型和稳定性，适当控制速率，以提升翻译的成功率和稳定性。
功能说明
翻译缓存
本工具引入可选的本地翻译缓存，提高翻译效率并降低资源消耗：
- 缓存规则：每段翻译结果将以
源文本_目标语言_源语言_翻译 API_模型设置作为唯一 key 进行存储。 - 缓存命中条件：只有完全匹配相同参数的情况下，才会使用本地缓存结果，确保准确性。
- 缓存作用：避免重复翻译，减少 API 调用次数，提高翻译速度。
如果不想使用缓存，可取消勾选“使用翻译缓存”，或在 API 设置中点击“清除翻译缓存”。
多语言翻译
支持将同一个文件一次性翻译为多种语言，特别适合需要国际化的视频内容：
- 例如：将英文文件同时翻译为中文、日语、德语、法语，方便全球用户使用。
- 支持 35 种主流语言，并将持续扩展。
使用须知
使用本工具时，请注意以下几点：
- DeepL 支持说明：由于 DeepL API 不支持网页端直接调用，我提供了一个服务器端转发接口，仅用于数据转发，不会收集用户数据。如需提高稳定性，用户也可选择自行部署此接口。
- 使用 DeepLX 免费接口，可能会返回 null。请等一会再使用，或使用自己的 API KEY 或自行部署转发接口。
- API Key 安全：本工具不会存储你的 API 密钥，所有配置数据均保存在本地浏览器中。
- GTX Web 接口说明：该接口对服务器压力较大，建议仅在本地部署时手动启用。请避免在开启全局代理的网络环境下使用，以免翻译出现异常。