DeepL Translate Selection
fanxin199262 downloadsTranslate selected text with DeepL from the editor context menu. Auto-detects Chinese English direction.
- Overview
- Scorecard
- Updates7
English
DeepL Translate Selection is an Obsidian plugin that translates selected text with the DeepL API or DeepSeek (OpenAI-compatible LLM). It is designed for quick Chinese-English translation from the editor context menu or command palette.
Features
| Feature | Description |
|---|---|
| Right-click translation | Select text, right-click, and run DeepL Translate. |
| Smart language direction | Detects Chinese to English or English to Chinese. |
| Output options | Insert below, replace the selection, or copy to clipboard. |
| Command palette support | Run DeepL: Translate Selection from the command palette. |
| Free and Pro API support | Supports DeepL Free and DeepL Pro API keys. |
| Quality-optimized model | Uses DeepL's quality_optimized model setting. |
| DeepSeek / LLM translation | Use DeepSeek or any OpenAI-compatible LLM as an alternative translation engine. |
| Professional translation prompt | Built-in system prompt constrains the LLM to produce clean, professional translations. |
Installation
From Obsidian Community Plugins
- Open Settings -> Community plugins -> Browse.
- Search for
DeepL Translate Selection. - Click Install, then Enable.
Manual installation
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Create a
deepl-translate-selection/folder in your vault's.obsidian/plugins/directory. - Copy the three files into that folder.
- Restart Obsidian and enable the plugin.
Setup
- Get a DeepL API key from deepl.com/pro-api.
- Open Settings -> DeepL Translate Selection.
- Paste your API key.
Keys ending in :fx are treated as DeepL Free API keys and routed to the DeepL Free endpoint.
DeepSeek setup
- Get a DeepSeek API key from platform.deepseek.com.
- Open Settings -> DeepL Translate Selection.
- Change Translation provider to DeepSeek.
- Paste your DeepSeek API key.
The default model is deepseek-v4-flash. You can change it or point the base URL to any OpenAI-compatible endpoint.
Usage
- Select text in the Markdown editor.
- Right-click and choose
DeepL Translate, or runDeepL: Translate Selectionfrom the command palette. - Review the translation in the modal.
- Choose Insert below, Replace selection, or Copy.
Settings
| Setting | Description | Default |
|---|---|---|
| Translation provider | Choose DeepL or DeepSeek | DeepL |
| DeepL API key | Your personal DeepL API key | Empty |
| Request timeout | Maximum request time before failing | 15000 ms |
| Fallback target language | Target language when detection is inconclusive | ZH |
| Model type | DeepL model setting | quality_optimized |
| DeepSeek API key | Your DeepSeek API key | Empty |
| DeepSeek model | Model identifier | deepseek-v4-flash |
| Temperature | Controls translation consistency (lower = more consistent) | 0.3 |
| API base URL | DeepSeek or OpenAI-compatible endpoint | https://api.deepseek.com |
| Custom system prompt | Override the built-in translation prompt (advanced) | Empty |
Privacy and network access
This plugin sends the selected text to the DeepL API or the configured LLM API only when you explicitly run a translation command. It does not perform background translation, analytics, telemetry, or tracking.
API keys are stored locally in Obsidian plugin settings. During translation requests, your key is sent only to the corresponding API endpoint for authentication. Translated text is written to the clipboard only when you choose the Copy action.
DeepL and DeepSeek are third-party services. Use of this plugin may require API accounts and is subject to each service's terms, privacy policy, and usage limits.
For more details, see PRIVACY.md.
中文
DeepL Translate Selection 是一款 Obsidian 插件，用于通过 DeepL API 或 DeepSeek（OpenAI 兼容 LLM）翻译编辑器中选中的文本，适合在中文和英文之间快速翻译。
核心功能
| 功能 | 说明 |
|---|---|
| 右键翻译 | 选中文本后右键运行 DeepL Translate。 |
| 智能方向判断 | 自动判断中文到英文或英文到中文。 |
| 三种输出方式 | 插入到下方、替换选中文本、复制到剪贴板。 |
| 命令面板支持 | 可通过命令面板运行 DeepL: Translate Selection。 |
| Free 和 Pro API | 支持 DeepL Free 与 DeepL Pro API key。 |
| 质量优化模型 | 使用 DeepL 的 quality_optimized 模型设置。 |
| DeepSeek / LLM 翻译 | 使用 DeepSeek 或任何 OpenAI 兼容 LLM 作为备选翻译引擎。 |
| 专业翻译提示词 | 内置系统提示词约束 LLM 输出干净、专业的翻译结果。 |
安装方法
从 Obsidian 社区插件安装
- 打开 设置 -> 第三方插件 -> 浏览。
- 搜索
DeepL Translate Selection。 - 点击安装，然后启用。
手动安装
- 从 latest release 下载
main.js、manifest.json和styles.css。 - 在 vault 的
.obsidian/plugins/目录下创建deepl-translate-selection/文件夹。 - 将三个文件复制到该文件夹。
- 重启 Obsidian 并启用插件。
配置
- 从 deepl.com/pro-api 获取 DeepL API key。
- 打开 设置 -> DeepL Translate Selection。
- 粘贴 API key。
以 :fx 结尾的 key 会被识别为 DeepL Free API key，并路由到 DeepL Free endpoint。
DeepSeek 配置
- 从 platform.deepseek.com 获取 DeepSeek API key。
- 打开 设置 -> DeepL Translate Selection。
- 将翻译引擎切换为 DeepSeek。
- 粘贴 DeepSeek API key。
默认模型为 deepseek-v4-flash。你可以更改模型名称，或将 Base URL 指向任何 OpenAI 兼容的 API endpoint。
使用方法
- 在 Markdown 编辑器中选中文本。
- 右键选择
DeepL Translate，或从命令面板运行DeepL: Translate Selection。 - 在弹窗中查看译文。
- 选择插入到下方、替换选中文本或复制到剪贴板。
设置选项
| 设置 | 说明 | 默认值 |
|---|---|---|
| 翻译引擎 | 选择 DeepL 或 DeepSeek | DeepL |
| DeepL API key | 你的 DeepL API key | 空 |
| 请求超时 | 请求失败前的最长等待时间 | 15000 ms |
| 备用目标语言 | 语言检测不确定时使用的目标语言 | ZH |
| 模型类型 | DeepL 模型设置 | quality_optimized |
| DeepSeek API key | 你的 DeepSeek API key | 空 |
| DeepSeek 模型 | 模型标识符 | deepseek-v4-flash |
| 温度 | 控制翻译一致性（越低越稳定） | 0.3 |
| API Base URL | DeepSeek 或 OpenAI 兼容的 API 端点 | https://api.deepseek.com |
| 自定义系统提示词 | 覆盖内置翻译提示词（高级） | 空 |
隐私与网络访问
插件只会在用户明确运行翻译命令时，将选中文本发送到 DeepL API 或配置的 LLM API。插件不会进行后台翻译、分析统计、遥测或跟踪。
API key 保存在本地 Obsidian 插件设置中。翻译请求发生时，API key 仅发送给对应的 API endpoint 用于认证。只有当用户选择 Copy 操作时，插件才会把译文写入剪贴板。
DeepL 和 DeepSeek 是第三方服务。使用本插件可能需要相应的 API 账户，并受各服务的条款、隐私政策和用量限制约束。
更多细节见 PRIVACY.md。
License
MIT © 2026 Yunfeng