DeepL Translate Selection
fanxin199659 downloadsTranslate selected text with DeepL from the editor context menu. Auto-detects Chinese English direction.
- Overview
- Scorecard
- Updates12
English
DeepL Translate Selection is an Obsidian plugin that translates selected text with the DeepL API or DeepSeek (OpenAI-compatible LLM). Version 1.3.2 supports reading and editing modes on Windows desktop and Android mobile with Obsidian 1.5.0 or later. In reading mode, tap Tr beside a heading or paragraph to translate it without selecting text. Automatic Tr buttons appear only on blocks containing English letters and no Chinese characters; Chinese paragraphs with terms such as CD4, IL-21 or PubMed stay uncluttered. Mixed Chinese/English paragraphs can still be translated through manual selection. After selecting a word, the plugin also offers Sentence and Paragraph actions.
Features
| Feature | Description |
|---|---|
| Right-click translation | Select text, right-click, and choose Translate. |
| Reading-mode translation | Tap Tr beside a heading or paragraph; select a word to reveal Selection, Sentence and Paragraph actions. |
| Mobile editing | Select text, then use the command palette, mobile toolbar, or languages ribbon button. |
| Smart language direction | Detects Chinese to English or English to Chinese. |
| Output options | Copy in reading mode; insert below, replace the selection, or copy in editing mode. |
| Command palette support | Search for Translate selection in 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.
- On Windows, right-click and choose
Translate, or search forTranslate selectionin the command palette. You can also use the languages ribbon button. - Review the translation in the modal.
- Choose Insert below, Replace selection, or Copy.
Android usage
- Update to 1.3.2 and enable the plugin. Existing API keys and settings are preserved.
- Open a note in reading mode. Tap Tr beside a heading or paragraph to translate its entire text, without dragging Android selection handles.
- To translate just a sentence, long-press any word in it, then tap Sentence in the plugin's floating toolbar. Selection translates exactly the highlighted text; Paragraph translates the whole paragraph. Android's native Copy/Select All menu is separate from this toolbar.
- Review and copy the translation. Reading-mode translation does not modify the note. If Android blocks automatic clipboard access, long-press the translated text and use the system Copy action.
Translate selection in the command palette and the languages ribbon button work in both reading and editing modes. Editing mode still offers Insert below and Replace selection. Configure a DeepL or DeepSeek key once if this is a new installation.
For manual installation, copy the release's three plugin files into the Android vault's .obsidian/plugins/deepl-translate-selection/ folder. Windows and Android use the same files. Update main.js, manifest.json, and styles.css together, preserving your existing data.json settings file.
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 selection, sentence, heading or paragraph you explicitly choose to translate to the DeepL API or the configured LLM API. 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）翻译笔记内容。1.3.2 版本支持 Windows 和 Android 的阅读与编辑模式，需要 Obsidian 1.5.0 或更高版本。阅读模式下直接点击标题或段落旁的“译”，即可翻译完整内容，无须拖动手机选区。自动“译”按钮只出现在含英文、不含中文的文本块旁；中文段落即使含 CD4、IL-21、PubMed 等术语也不会显示按钮。中英混合段落仍可手动选中翻译；选中一个单词后，也可以选择“翻译整句”或“翻译整段”。
核心功能
| 功能 | 说明 |
|---|---|
| 右键翻译 | 选中文本后右键选择 Translate。 |
| 阅读模式翻译 | 点击标题或段落旁的“译”；选中单词后可选择翻译选中、整句或整段。 |
| 手机编辑模式 | 选中文本后通过命令面板、移动工具栏或侧边栏语言按钮翻译。 |
| 智能方向判断 | 自动判断中文到英文或英文到中文。 |
| 输出方式 | 阅读模式支持复制；编辑模式支持插入、替换或复制。 |
| 命令面板支持 | 可通过命令面板搜索 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 编辑器中选中文本。
- Windows 上右键选择
Translate，或从命令面板搜索Translate selection。也可以点击侧边栏的语言按钮。 - 在弹窗中查看译文。
- 选择插入到下方、替换选中文本或复制到剪贴板。
Android 手机使用
- 将插件更新到 1.3.2 并启用，已有 API key 和设置会保留。
- 打开笔记的阅读模式，点击标题或段落旁的 “译”，即可翻译整个标题或段落，无须拖动手机的选择手柄。
- 如果只想翻译一句话，长按这句话里的任意单词，然后点击插件浮动工具栏中的 “翻译整句”。“翻译选中”仅翻译高亮部分，“翻译整段”翻译整个段落。安卓系统的“复制、全选”菜单和插件工具栏是两个独立入口。
- 查看并复制译文。阅读模式下不会修改笔记。如果 Android 拒绝自动复制，可以长按译文，使用系统的复制操作。
命令面板中的 Translate selection 和侧边栏语言按钮现在同时支持阅读与编辑模式。编辑模式保留插入和替换功能。新安装时需要配置一次 DeepL 或 DeepSeek API key。
手动安装时，将发布的三个插件文件复制到 Android 手机仓库的 .obsidian/plugins/deepl-translate-selection/ 目录。Windows 和 Android 使用同一套文件。更新时同时替换 main.js、manifest.json、styles.css，保留已有的 data.json 设置文件。
设置选项
| 设置 | 说明 | 默认值 |
|---|---|---|
| 翻译引擎 | 选择 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。
Development and releases / 开发与发布
Run npm ci, npm run typecheck, and npm test. Tests build main.js and exercise selection handling, output actions, clipboard fallback, and provider requests with a mocked Obsidian host. Native selection mappings also run against actual CodeMirror editor DOMs in jsdom. Run npm run test:mobile with Chrome/Chromium installed (or set MOBILE_TEST_BROWSER to its executable). It uses real Chromium DOM and touch input at a phone viewport to exercise heading translation, sentence expansion and mobile controls, with a mocked Obsidian host and translation API. These tests also run before release publication. They do not replace Windows or Android device testing. CodeMirror is provided by Obsidian at runtime; jsdom and Playwright are used only for development tests.
Version tags trigger GitHub Actions to test, build, and publish the three Obsidian plugin files. See release and network configuration instructions.
License
MIT © 2026 Yunfeng