README file from
GithubObsidian Bilingual Translator
中文版 | English
A powerful Obsidian plugin that translates English articles into a beautiful Chinese bilingual (Parallel) format. Perfect for personal knowledge management, research, and learning.
✨ Features
- 🚀 Multiple Master Engines:
- Google Gemini 3.1 Flash-Lite: Ultra-fast, high-quality, and free-tier support.
- MiniMax M2.7: State-of-the-art Chinese LLM for natural expression.
- DeepSeek: Cost-effective and highly precise English-Chinese translation.
- Microsoft Translator: Solid fallback for high-volume free translation.
- 🖱️ Seamless Integration:
- Right-click Menu: Translate the entire note or just the selected text instantly.
- Parallel Content: Paragraph-by-paragraph bilingual layout for better reading.
- 📦 Intelligent Format Preservation:
- Keeps all Markdown syntax, LaTeX, and code blocks intact.
- Automatically skips YAML frontmatter and internal [[links]].
- 📑 Long Article Support:
- Intelligent text chunking to handle large articles without hitting API timeouts.
- Real-time progress notifications.
🚀 Getting Started
1. Installation
- Community Store: Search for
Bilingual Translatorin Obsidian Community Plugins (Coming soon!). - Manual: Download
main.js,manifest.json, andstyles.cssfrom the latest release and place them in your vault's.obsidian/plugins/bilingual-translator/folder.
2. Configuration
Go to Obsidian Settings -> Bilingual Translator and set up your preferred engine:
- DeepSeek: Get your key at platform.deepseek.com.
- Gemini: Get your key at Google AI Studio.
- MiniMax: Get your key at MiniMax Open Platform.
3. Usage
- Option A: Right-click anywhere in an English note ->
Translate note (bilingual parallel). - Option B: Highlight a paragraph -> Right-click ->
Translate selection (bilingual parallel). - Option C: Use Command Palette (
Cmd + P) -> SearchBilingual Translator.
🛠️ Build from Source
npm install
npm run build
📄 License
MIT License.