# MathML vs OMML 格式对比
## 快速选择指南
| 使用场景 | 推荐格式 | API 端点 |
|---------|---------|----------|
| 手动复制粘贴到 Word | MathML | `/image/ocr` 返回 `mathml` |
| 网页显示公式 | MathML | `/image/ocr` 返回 `mathml` |
| Office.js 插件开发 | OMML | `/convert/latex-to-omml` |
| Python 生成 Word 文档 | OMML | `/convert/latex-to-omml` |
| 跨平台显示 | MathML | `/image/ocr` 返回 `mathml` |
## 格式详解
### MathML (Mathematical Markup Language)
**标准**: W3C 标准
**浏览器支持**: Chrome, Firefox, Safari (原生支持)
**Word 支持**: 可粘贴 (Word 自动转换为 OMML)
#### 示例
```xml
```
#### 优点
- ✅ 跨平台标准
- ✅ 浏览器原生支持
- ✅ 可读性好
- ✅ 可直接粘贴到 Word
#### 缺点
- ❌ Word 内部需要转换
- ❌ 渲染精度依赖 Word 转换器
### OMML (Office Math Markup Language)
**标准**: Microsoft 专有格式
**浏览器支持**: 不支持
**Word 支持**: 原生格式 (最佳兼容性)
#### 示例
```xml
a
b
```
#### 优点
- ✅ Word 原生格式，渲染最准确
- ✅ 适合编程生成 Word 文档
- ✅ Office.js API 直接支持
#### 缺点
- ❌ 仅 Word 支持
- ❌ 可读性差
- ❌ 不能浏览器渲染
## API 使用示例
### 1. 获取 MathML (手动粘贴到 Word)
```bash
# OCR 识别图片，返回 MathML
curl -X POST "http://localhost:8000/api/v1/image/ocr" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/formula.png",
"model_name": "mineru"
}'
```
响应：
```json
{
"latex": "\\frac{a}{b}",
"markdown": "$\\frac{a}{b}$",
"mathml": "", // 👈 复制这个粘贴到 Word
"mml": "..."
}
```
### 2. 获取 OMML (编程插入 Word)
```bash
# 转换 LaTeX 为 OMML
curl -X POST "http://localhost:8000/api/v1/convert/latex-to-omml" \
-H "Content-Type: application/json" \
-d '{
"latex": "\\frac{a}{b}"
}'
```
响应：
```json
{
"omml": "..." // 👈 用于编程插入
}
```
## 编程使用示例
### Python: 插入 OMML 到 Word
```python
from docx import Document
from docx.oxml import parse_xml
# 获取 OMML
import requests
response = requests.post(
"http://localhost:8000/api/v1/convert/latex-to-omml",
json={"latex": "\\frac{a}{b}"}
)
omml = response.json()["omml"]
# 插入到 Word 文档
doc = Document()
paragraph = doc.add_paragraph()
paragraph._element.append(parse_xml(omml))
doc.save("output.docx")
```
### JavaScript: Office Add-in 插入 OMML
```javascript
// 获取 OMML
const response = await fetch('http://localhost:8000/api/v1/convert/latex-to-omml', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ latex: '\\frac{a}{b}' })
});
const { omml } = await response.json();
// 插入到 Word
Office.context.document.setSelectedDataAsync(
omml,
{ coercionType: Office.CoercionType.Ooxml }
);
```
### Web: 显示 MathML
```html
```
## 性能对比
| 操作 | MathML | OMML |
|------|--------|------|
| 生成速度 | 快 (~100ms) | 慢 (~500ms, 需要 Pandoc) |
| 文件大小 | 较小 | 较大 |
| 转换质量 | 依赖转换器 | 原生最佳 |
## 常见问题
### Q1: 为什么我的 OMML 看起来很长？
**A**: OMML 包含了完整的命名空间和样式信息，所以比 MathML 长。这是正常的。
### Q2: 我应该使用哪个格式？
**A**:
- **手动操作** → MathML (复制粘贴)
- **编程操作** → OMML (API 插入)
### Q3: 能否将 MathML 转换为 OMML？
**A**: 可以！使用我们的 API：
1. 先从 OCR 获取 `latex`
2. 再调用 `/convert/latex-to-omml` 获取 OMML
### Q4: OMML 能在浏览器显示吗？
**A**: 不能。OMML 是 Word 专用格式。浏览器显示请使用 MathML。
## 总结
- 📋 **用户复制粘贴** → 使用 MathML
- 💻 **编程生成文档** → 使用 OMML
- 🌐 **网页显示** → 使用 MathML
- 🔌 **Office 插件** → 使用 OMML