# convert

## 功能

将文件转换为 Markdown 格式。支持 PDF、Word、Excel、PPT、HTML、CSV、JSON、XML、EPUB、ZIP 等格式。

## 工具定义

### tool: convert_to_markdown
**description:** 将文档文件转换为 Markdown 格式。
**parameters:**
  - file (file, required): 要转换的文件

**api endpoint:** `POST https://convert.shxai.space`

## 示例

```bash
# PDF 转 Markdown
curl -X POST https://convert.shxai.space -F "file=@document.pdf"

# Word 转 Markdown
curl -X POST https://convert.shxai.space -F "file=@document.docx"
```

## 支持的格式

PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, EPUB, ZIP

## 鉴权（必需）

调用本 API 必须携带 API Key，未携带返回 401。

- 演示 Key: `demo-key-123`（每日限 10 次）
- 正式 Key: 通过 https://shxai.space/skills.html 获取

```bash
curl -X POST "https://convert.shxai.space?key=demo-key-123" -F "file=@document.pdf"
```

---
> Skill 版本: 1.0 | 平台: shxai.space | 更新: 2026-08
