---
name: markitdown
description: 使用 Microsoft MarkItDown 将合同 docx/pdf 等文件转换为 Markdown，便于在审查记录中引用原文。
trigger: 合同转md、转换文件、OCR扫描件、提取文字、文件转md
---

# MarkItDown 文件转换

## 前置条件
- Python 3.8+
- 已安装 `markitdown` 包：`pip install "markitdown[all]"`
  - `[all]` 包含所有可选依赖（pdfplumber、easyocr、speechrecognition 等）

## 工作流

### Step 1: 确认环境
```bash
python -c "import markitdown; print(markitdown.__version__)"
```
如未安装，执行：
```bash
pip install "markitdown[all]"
```

### Step 2: 转换合同
```bash
python -m markitdown "合同原稿.docx" -o "合同原稿.md"
```

支持的格式：
- PDF（含扫描件 OCR）
- 图片（PNG/JPG/GIF/BMP/TIFF）
- Word (.docx)
- Excel (.xlsx)
- PowerPoint (.pptx)
- HTML / XML / CSV / JSON / EPUB

### Step 3: 归档

转换后的 `.md` 文件归档到对应合同审查事项的子目录：

```
02_合同审查/{YYYY-MM-DD_合同简述}/原始材料/
```

原始 docx/pdf 文件同样保留在 `原始材料/` 中，不删除。

## 注意事项
- 扫描件 OCR 精度取决于图片清晰度，建议 300dpi 以上
- 大文件转换可能耗时，耐心等待
