# Zh Translator

> Translate Markdown content from any language to Chinese while preserving formatting, code blocks, formulas, and special elements. Use when you need accurate Chinese translation of technical documents.

- Skill: `threefish-ai/zh-translator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add threefish-ai/zh-translator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/threefish-ai/zh-translator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ThreeFish-AI (https://skillmd.com/u/threefish-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/threefish-ai/zh-translator

---


# Chinese Translator (zh-translator)

专门负责将 Markdown 格式的内容精确翻译为中文，同时保持原有的格式、代码块、公式和特殊元素不变。

## 核心功能

### 1. 智能内容识别

- **可翻译内容**：段落文本、标题、列表项、表格内容
- **不可翻译内容**：
  - 代码块（`code`）
  - 行内代码（`code`）
  - URL 链接
  - 图片路径
  - LaTeX 公式（$...$ 和 $$...$$）
  - HTML 标签
  - 特殊标记（如 DOI、ISBN 等）

### 2. 翻译策略

- **上下文感知**：理解段落和章节的上下文关系
- **术语一致性**：保持专业术语的一致性
- **风格统一**：使用正式、专业的翻译风格
- **文化适配**：适当的文化本地化

## Workflow

### 输入处理

1. 接收 Markdown 格式内容
2. 解析文档结构
3. 识别可翻译和不可翻译的部分
4. 建立术语表（可选）

### 翻译执行

1. **分段处理**

   - 按段落或语义单元分割
   - 保持上下文连续性
   - 记录翻译进度

2. **翻译实施**

   - 精确翻译文本内容
   - 保持原有格式标记
   - 处理特殊语法

3. **质量保证**
   - 检查翻译完整性
   - 验证格式保持
   - 术语一致性检查

### 输出生成

1. 组装翻译后的 Markdown
2. 验证格式正确性
3. 生成翻译报告

## 特殊处理规则

### 代码块

````markdown
```python
# 这部分不翻译
print("Hello, World!")
```
````

### 数学公式

```markdown
行内公式：$E = mc^2$

块级公式：

$$
  \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$
```

### 图片和链接

```markdown
![原始描述](path/to/image.png)
[链接文本](https://example.com)
```

### 表格

```markdown
| Header 1 | Header 2 |
| -------- | -------- |
| 内容 1   | 内容 2   |
```

只翻译表头和内容，保持表格结构。

## 使用方法

### 基本翻译

```
将这个 Markdown 文档翻译成中文：document.md
```

### 指定术语

```
翻译文档，"API Key" 保持不变：document.md
```

### 技术文档

```
翻译这个技术文档，保持专业术语一致性：technical_guide.md
```

### 批量处理

```
翻译这些 Markdown 文件：
- doc1.md
- doc2.md
- doc3.md
```

## 高级功能

### 术语表管理

支持自定义术语表，确保特定词汇的翻译一致性：

```json
{
  "terminology": {
    "API Key": "API密钥",
    "Framework": "框架",
    "Repository": "仓库"
  }
}
```

### 翻译模式

- **完整模式**：翻译所有可翻译内容
- **保守模式**：仅翻译明确的文本内容
- **技术模式**：针对技术文档优化

### 质量检查

- 翻译完整性验证
- 格式一致性检查
- 术语一致性报告
- 可疑翻译标记

## 输出格式

返回结构化结果：

```json
{
  "success": true,
  "translated_content": "翻译后的 Markdown 内容",
  "statistics": {
    "total_paragraphs": 50,
    "translated_paragraphs": 45,
    "skipped_elements": {
      "code_blocks": 5,
      "formulas": 3,
      "urls": 10
    },
    "word_count": {
      "original": 2500,
      "translated": 3800
    }
  },
  "terminology_used": {
    "API": "应用程序接口",
    "Framework": "框架"
  },
  "quality_issues": [
    {
      "type": "uncertain_translation",
      "line": 25,
      "suggestion": "建议人工复核"
    }
  ]
}
```

## 注意事项

1. **格式保持**：严格保持原始 Markdown 格式
2. **特殊内容**：正确识别并保护不可翻译内容
3. **术语一致性**：建立和维护术语表
4. **上下文理解**：考虑文档整体上下文
5. **质量验证**：提供翻译质量评估

## 最佳实践

### 文档预处理

- 清理不必要的格式
- 标记不需要翻译的部分
- 准备术语表

### 翻译后处理

- 检查格式是否正确
- 验证链接和引用
- 人工复核关键内容

### 持续改进

- 收集翻译反馈
- 更新术语表
- 优化翻译质量