---
name: file-converter
description: 文件格式转换工具，支持 Markdown 转 HTML、Markdown 转 PDF、CSV 转 Excel、图片格式转换（PNG/JPG/WEBP 等互转）。当用户需要转换文件格式时使用此技能。触发词：转换、转为、转成、convert to、markdown to html、csv to excel、图片转换、格式转换。
---

# File Converter

支持以下四种文件转换：

1. **Markdown 转 HTML** - 将 .md 文件转换为网页
2. **Markdown 转 PDF** - 将 .md 文件转换为 PDF（需要 pandoc）
3. **CSV 转 Excel** - 将 .csv 文件转换为 .xlsx
4. **图片格式转换** - PNG、JPG、WEBP、GIF、BMP 等互转

## 使用方法

### 1. Markdown 转 HTML

运行脚本：
```bash
python scripts/md_to_html.py input.md [output.html]
```

示例：
```bash
python scripts/md_to_html.py README.md
python scripts/md_to_html.py README.md output.html
```

依赖：`pip install markdown`

### 2. Markdown 转 PDF

运行脚本：
```bash
python scripts/md_to_pdf.py input.md [output.pdf]
```

示例：
```bash
python scripts/md_to_pdf.py document.md
python scripts/md_to_pdf.py document.md output.pdf
```

依赖：需要安装 [pandoc](https://pandoc.org/installing.html)

- Windows: `choco install pandoc`
- macOS: `brew install pandoc`
- Linux: `sudo apt-get install pandoc`

### 3. CSV 转 Excel

运行脚本：
```bash
python scripts/csv_to_excel.py input.csv [output.xlsx]
```

示例：
```bash
python scripts/csv_to_excel.py data.csv
python scripts/csv_to_excel.py data.csv output.xlsx
```

依赖：`pip install pandas openpyxl`

### 4. 图片格式转换

运行脚本：
```bash
python scripts/convert_image.py input.png output.jpg
```

示例：
```bash
python scripts/convert_image.py photo.png photo.jpg
python scripts/convert_image.py image.webp image.png
```

支持格式：PNG, JPG, JPEG, WEBP, GIF, BMP, Tiff, ICO 等

依赖：`pip install Pillow`

## 安装依赖

一键安装所有 Python 依赖：
```bash
pip install markdown pandas openpyxl Pillow
```

pandoc（用于 MD 转 PDF）需要单独安装（见上文）。

## 脚本说明

- `scripts/md_to_html.py` - Markdown 转 HTML
- `scripts/md_to_pdf.py` - Markdown 转 PDF（需要 pandoc）
- `scripts/csv_to_excel.py` - CSV 转 Excel
- `scripts/convert_image.py` - 图片格式转换
