mdcarrot 🥕
專業 Markdown 繁體中文翻譯工具 | Professional Markdown Traditional Chinese Translator for VS Code

將您的 Markdown 文件轉換為繁體中文,具備專業級翻譯工具、智慧快取和無縫 VS Code 整合。
Transform your Markdown documents into Traditional Chinese with professional-grade translation tools, intelligent caching, and seamless VS Code integration.
🌟 主要功能 | Key Features
🎯 分割視窗翻譯介面 | Split-Pane Translation Interface
- 左右並排顯示原始 markdown(左)和繁體中文翻譯(右)
- 原生 VS Code 整合,具備完整語法高亮和編輯功能
- 清晰的分頁標題顯示原始檔名和翻譯內容
🌐 多供應商支援 | Multi-Provider Support
- Google 翻譯 - 快速可靠(推薦)
- Azure 翻譯 - 企業級翻譯服務
- Amazon 翻譯 - AWS 驅動的翻譯服務
- 智慧備援 - 自動使用可用的已配置供應商
💰 成本優化 | Cost Optimization
- 智慧快取 - 相同文字絕不重複翻譯
- 重複消除 - 自動優化 API 使用
- 供應商專屬快取 - 每個翻譯服務獨立快取
- 持久儲存 - 快取在 VS Code 重啟後保留
🎨 原生 VS Code UI
- 編輯器標題按鈕 - 儲存、重新整理和供應商切換
- 狀態列整合 - 顯示目前翻譯供應商
- 右鍵選單 - 右鍵存取翻譯功能
- 智慧警告 - 需要時提供配置指導
🚀 快速開始 | Quick Start
安裝 | Installation
從 VS Code 市集 安裝
基本使用 | Basic Usage
- 在 VS Code 中開啟任何
.md 檔案
- 按
Ctrl+Shift+T(Mac: Cmd+Shift+T)或使用命令面板:「Open with mdcarrot」
- 檢視分割視窗,原始內容(左)和翻譯(右)
- 使用編輯器標題按鈕進行儲存、重新整理和供應商操作
⚙️ 配置 | Configuration
在 VS Code 設定中配置至少一個翻譯供應商:
Google 翻譯(推薦)| Google Translate (Recommended)
{
"mdcarrot.provider": "google",
"mdcarrot.google.apiKey": "YOUR_API_KEY"
}
Azure 翻譯 | Azure Translator
{
"mdcarrot.provider": "azure",
"mdcarrot.azure.key": "YOUR_KEY",
"mdcarrot.azure.region": "eastus"
}
Amazon 翻譯 | Amazon Translate
{
"mdcarrot.provider": "amazon",
"mdcarrot.aws.accessKeyId": "YOUR_ACCESS_KEY",
"mdcarrot.aws.secretAccessKey": "YOUR_SECRET_KEY",
"mdcarrot.aws.region": "us-east-1"
}
🎮 命令與快捷鍵 | Commands & Shortcuts
| 命令 Command |
快捷鍵 Shortcut |
說明 Description |
| Open with mdcarrot |
Ctrl+Shift+T |
啟動分割視窗翻譯介面 |
| Save Translation |
編輯器標題按鈕 |
以自訂檔名儲存翻譯 |
| Refresh Translation |
編輯器標題按鈕 |
重新翻譯目前文件 |
| Change Provider |
狀態列點擊 |
切換翻譯供應商 |
🔧 進階功能 | Advanced Features
智慧快取系統 | Smart Caching System
- 文字層級快取,個別句子儲存
- 供應商專屬快取管理
- 自動重複消除
- 成本優化追蹤
- 完整 Markdown 語法保留
- 程式碼區塊保持不翻譯
- 連結和參考維持原狀
- 表格格式保留
- Frontmatter 處理
專業工作流程 | Professional Workflow
- 自訂儲存名稱,建議
_zh-TW 後綴
- 就地重新整理,不建立新分頁
- 供應商驗證與智慧警告
- 優雅的錯誤處理和備援
📋 系統需求 | Requirements
- VS Code 1.74.0 或更高版本
- 所選翻譯供應商的 API 憑證
- 翻譯服務的網路連線
🔒 隱私與安全 | Privacy & Security
- API 金鑰安全儲存在 VS Code 設定中
- mdcarrot 不保留任何資料
- 直接與翻譯服務 API 通訊
- 所有文件處理在本地進行
🤝 貢獻 | Contributing
歡迎貢獻!請參閱 CONTRIBUTING.md 了解指導原則。
📄 授權 | License
本專案採用 MIT 授權 - 詳見 LICENSE 檔案。
🐛 問題與支援 | Issues & Support
用 🥕 為開發者社群製作 | Made with 🥕 for the developer community