万能文档转 Markdown 工具

技能文档

---
name: markdown-converter
title: "万能文档转 Markdown 工具"
category: "办公效率"
description: "使用 markitdown 将 PDF、Word、PPT、Excel、HTML、图片、音频、ZIP、YouTube 等 20+ 种格式一键转换为 Markdown。当用户需要转换文档格式、将文件转为 Markdown、批量转换文档、文档转 md、markitdown 转换时触发。触发词：转 Markdown、转换文档、文档转 md、批量转换、PDF 转 Markdown、Word 转 Markdown。"
---

# 万能文档转 Markdown 工具

使用 `uvx markitdown` 将各类文件转换为 Markdown，无需手动安装依赖。

## 技能工作流

### 步骤 1：确认输入文件

确认用户提供的文件路径或输入方式（文件路径、标准输入、URL 等）。

### 步骤 2：执行转换

根据场景选择合适的转换命令：

```bash
# 转换并输出到终端
uvx markitdown input.pdf

# 转换并保存到文件
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# 从标准输入读取
cat input.pdf | uvx markitdown
```

### 步骤 3：处理特殊场景

**指定文件类型（标准输入时）：**

```bash
cat document | uvx markitdown -x .pdf > output.md
```

**使用 Azure Document Intelligence 提升 PDF 提取质量：**

```bash
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
```

## 支持的格式

- **文档类**：PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)
- **网页/数据类**：HTML、CSV、JSON、XML
- **媒体类**：图片（EXIF + OCR）、音频（EXIF + 转录）
- **其他**：ZIP（遍历内容）、YouTube 链接、EPub

## 常用参数

```bash
-o OUTPUT      # 指定输出文件
-x EXTENSION   # 提示文件扩展名（用于标准输入）
-m MIME_TYPE   # 提示 MIME 类型
-c CHARSET     # 提示字符集（如 UTF-8）
-d             # 使用 Azure Document Intelligence
-e ENDPOINT    # Document Intelligence 端点
--use-plugins  # 启用第三方插件
--list-plugins # 查看已安装插件
```

## 转换示例

```bash
# 转换 Word 文档
uvx markitdown report.docx -o report.md

# 转换 Excel 表格
uvx markitdown data.xlsx > data.md

# 转换 PowerPoint 演示文稿
uvx markitdown slides.pptx -o slides.md
```

## 注意事项

- 输出保留文档结构：标题、表格、列表、链接
- 首次运行会缓存依赖，后续运行更快
- 对于复杂 PDF 提取效果不佳时，使用 `-d` 配合 Azure Document Intelligence

使用说明

# 万能文档转 Markdown 工具

一键将 PDF、Word、PPT、Excel、HTML、图片、音频、ZIP 等 20+ 种格式转换为 Markdown，基于 `markitdown`，无需手动安装依赖。

## 支持格式

| 类别 | 格式 |
|------|------|
| 文档 | PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx/.xls) |
| 网页/数据 | HTML、CSV、JSON、XML |
| 媒体 | 图片（OCR）、音频（转录） |
| 其他 | ZIP、YouTube 链接、EPub |

## 快速上手

```bash
# 转换并输出到终端
uvx markitdown input.pdf

# 转换并保存到文件
uvx markitdown input.pdf -o output.md

# 从标准输入读取
cat input.pdf | uvx markitdown
```

## 常用参数

- `-o OUTPUT` — 指定输出文件
- `-x EXTENSION` — 提示文件扩展名（用于标准输入）
- `-d` — 使用 Azure Document Intelligence 提升 PDF 提取质量
- `-e ENDPOINT` — Document Intelligence 端点地址

## 注意事项

- 输出自动保留文档结构（标题、表格、列表、链接）
- 首次运行会缓存依赖，后续运行速度更快
- 复杂 PDF 建议使用 `-d` 参数配合 Azure Document Intelligence

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。