Name: Markitdown Converter
Author: 軍艦

據 AlphaMoat 統計,截至 2026-09,Markitdown Converter 累計下載 1,607 次、獲 1 個星標,在全部 5,078 個 AI 技能中排名第 4,698 位,在「辦公效率」分類(435 個)中排名第 376 位。

累計安裝

174

累計下載

1607

星標

全站排名

#4,698

全站前 93% · 「辦公效率」前 87%

平台	累計安裝	累計下載	星標	評論
ClawHub ↗	25	1062	1	-
SkillHub ↗	174	1607	1	—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

主文列出 PDF、Office、HTML、圖片及文字等輸入，並描述批次轉換和盡力提取圖片。轉換不保證保留所有佈局或圖片；應在隔離環境處理敏感檔案，使用虛擬環境並檢查輸出與依賴。

資料釋出於 2026-10-27

可以用來做什麼

轉換單個文件供後續檢索
整理批次檔案轉換流程
檢查圖像提取和格式保留情況

什麼時候用

需要提取文件文字或轉為 Markdown 時
確認檔案許可權、輸出位置和敏感內容處理方式時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

將這個檔案轉換為 Markdown 並報告轉換缺失；不要覆蓋原檔案，先說明將寫入的位置。

月度資料趨勢

累計下載1607

星標1

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。該技能有同名的其他版本,調整前的資料歸屬當前下載量最大的這一個。

月份	累計下載	環比	星標
2026-09	1607	—	1
2026-08	1112	+18.3%	1
2026-07	940	+32.2%	1
2026-06	711	+21.3%	1
2026-05	586	—	1
2026-03	287	—	-

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。

3.0 KB · ClawHub v1.0.0

---
name: markitdown-converter
description: 使用微软 markitdown 库将多种文档格式（PDF、DOC、DOCX、PPT、HTML等）转换为 Markdown。支持批量转换、保留格式、图片提取等功能。使用场景：(1) "把这个 PDF 转成 Markdown"，(2) "批量转换这个文件夹里的文档"，(3) "提取文档中的图片"。
---

# MarkItDown 文档转换技能

使用微软的 markitdown 库将各种文档格式转换为 Markdown。

## 支持的格式

展開全部(共 134 行)


- PDF (.pdf)
- Word 文档 (.doc, .docx)
- PowerPoint 演示文稿 (.ppt, .pptx)
- Excel 电子表格 (.xlsx)
- HTML 文件 (.html, .htm)
- 图片文件 (通过 OCR)
- 纯文本文件
- 等等...

## 快速开始

### 单个文件转换

```python
from markitdown import MarkItDown

md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)
```

### 使用提供的脚本

```bash
# 转换单个文件
python3 scripts/convert.py input.pdf output.md

# 批量转换文件夹
python3 scripts/batch_convert.py input_folder/ output_folder/

# 提取文档中的图片
python3 scripts/extract_images.py document.pdf images_folder/
```

## 详细用法

### 单个文件转换

使用 `scripts/convert.py`：

```bash
python3 scripts/convert.py <input_file> [output_file]
```

如果不指定输出文件，会自动生成 `.md` 文件。

### 批量转换

使用 `scripts/batch_convert.py`：

```bash
python3 scripts/batch_convert.py <input_directory> <output_directory>
```

会递归处理目录中的所有支持的文件。

### 图片提取

使用 `scripts/extract_images.py`：

```bash
python3 scripts/extract_images.py <input_file> <output_directory>
```

从文档中提取所有图片并保存到指定目录。

## 脚本说明

- `scripts/convert.py` - 单个文件转换脚本
- `scripts/batch_convert.py` - 批量转换脚本
- `scripts/extract_images.py` - 图片提取脚本

每个脚本都有 `--help` 选项查看详细参数。

## 安装依赖

### Python 版本要求

markitdown 需要 Python 3.10 或更高版本。

检查 Python 版本：
```bash
python3.12 --version  # 或 python3.11, python3.13
```

### 安装 markitdown

使用 Python 3.10+ 安装：

```bash
# 使用 Python 3.12（推荐）
python3.12 -m pip install --user --break-system-packages "markitdown[all]"

# 或使用虚拟环境
python3.12 -m venv markitdown-env
source markitdown-env/bin/activate
pip install "markitdown[all]"
```

### 可选：系统依赖

某些格式转换可能需要额外的系统依赖：

- **PDF 处理**: `brew install poppler` (macOS) 或 `apt install poppler-utils` (Linux)
- **OCR**: `brew install tesseract` (macOS) 或 `apt install tesseract-ocr` (Linux)

## 验证安装

```bash
python3.12 -c "from markitdown import MarkItDown; print('安装成功!')"
```

## 使用脚本

所有脚本都支持使用特定 Python 版本运行：

```bash
# 使用 Python 3.12 运行
python3.12 scripts/convert.py input.pdf output.md
python3.12 scripts/batch_convert.py input_folder/ output_folder/
python3.12 scripts/extract_images.py document.pdf images_folder/
```