據 AlphaMoat 統計,截至 2026-10,文件整理技能 (convert-markdown) 累計下載 13,901 次、獲 2 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 2,010 位,在「辦公效率」分類(909 個)中排名第 233 位。
列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。
| 平台 | 累計下載 | 星標 | 評論 |
|---|---|---|---|
| ClawHub ↗ | 1442 | - | - |
| SkillHub ↗ | 1.4萬 | 2 | — |
各平台的計數口徑不同,統計時間不一致。
基於 MarkItDown,支援 PDF、Word、PowerPoint、Excel、圖片、音訊、HTML、CSV 等格式的批次轉換,並儘量保留標題、列表、表格與連結等結構。適合文件數字化、知識庫入庫和正文提取。 格式支援取決於已安裝的選用相依套件,轉換可能遺漏內容或版面;應對照原始檔案檢查輸出。
資料釋出於 2026-10-27
以下是根據技能文件生成的示例,不代表實際執行結果。
2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。
| 月份 | 累計下載 | 環比 | 星標 |
|---|---|---|---|
| 2026-10 | 1.4萬 | — | 2 |
| 2026-09 | 7512 | — | 1 |
| 2026-08 | 5984 | +14.3% | 1 |
| 2026-07 | 5234 | +22.5% | 1 |
| 2026-06 | 4271 | +20.7% | 1 |
| 2026-05 | 3539 | — | 1 |
| 2026-03 | 1525 | — | - |
以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。
--- name: convert-markdown version: 1.0.3 description: 文档处理与转换技能,基于 MarkItDown 工具。支持将 PDF、Word、PowerPoint、Excel、图片、音频等多种格式文件批量转换为 Markdown。适用于文档数字化、知识库构建、内容提取等场景。 --- # 文档转换技能 (convert-markdown) ## 概述
MarkItDown 是 Microsoft 开发的多功能文档转换工具,能够将各种文件格式高质量转换为 Markdown 格式。本技能提供完整的文档处理工作流,包括:
- **多格式支持**:PDF、DOCX、PPTX、XLSX、图片、音频、HTML、CSV、JSON、ZIP、EPub、YouTube URLs 等
- **结构化保留**:保持标题、列表、表格、链接等重要文档结构
- **批量处理**:支持目录递归处理和批量转换
- **OCR 能力**:图片和扫描 PDF 的文本识别
- **音频转录**:音频文件的语音转文本
- **可扩展性**:可选依赖组按需安装,适配不同需求场景
## 快速开始
### 1. 环境准备
确保已安装 Python 3.10 或更高版本。建议使用虚拟环境:
```bash
# 创建虚拟环境
python -m venv .venv
# 激活虚拟环境
# Windows:
.venv\Scripts\activate
# Linux/Mac:
source .venv/bin/activate
```
### 2. 安装 MarkItDown
```bash
# 安装完整功能(推荐)
pip install 'markitdown[all]'
# 或按需安装特定格式支持
pip install 'markitdown[pdf,docx,pptx]'
```
可选依赖组说明:
- `[all]` - 所有格式支持(PDF、Office、图片、音频、HTML 等)
- `[pdf]` - PDF 处理(包含 OCR)
- `[docx]` - Word 文档
- `[pptx]` - PowerPoint
- `[xlsx]` - Excel
- `[image]` - 图片 EXIF 和 OCR
- `[audio]` - 音频转录
- `[html]` - HTML 转换
- `[ytdlp]` - YouTube 下载
### 3. 基本使用
#### NPX CLI 方式(推荐)
本技能提供 NPX CLI 工具,可直接通过 npx 命令调用:
```bash
# 查看帮助
npx convert-markdown
# 转换单个文件
npx convert-markdown convert --input document.pdf --output document.md
# 转换目录
npx convert-markdown convert --input ./docs --output ./markdown
# 批量转换(指定格式)
npx convert-markdown batch --source ./docs --target ./markdown --include .pdf,.docx
# 覆盖已存在文件
npx convert-markdown convert --input document.pdf --output document.md --overwrite
```
**CLI 命令说明:**
| 命令 | 说明 | 参数 |
|------|------|------|
| `convert` | 转换文件或目录 | `--input`, `--output`, `--overwrite` |
| `batch` | 批量转换目录 | `--source`, `--target`, `--include`, `--exclude` |
#### MarkItDown 命令行方式
转换单个文件:
```bash
markitdown document.pdf > document.md
markitdown presentation.pptx -o slides.md
```
批量处理目录:
```bash
# 转换当前目录所有支持文件
markitdown *.pdf *.docx *.pptx
# 递归处理子目录
markitdown ./docs/ --recursive
# 输出到指定目录
markitdown ./source/ -o ./output/
```
#### Python API 方式
```python
from markitdown import MarkItDown
# 创建转换器实例
md = MarkItDown()
# 转换文件
result = md.convert("document.pdf")
print(result.text_content)
# 转换并保存
with open("output.md", "w", encoding="utf-8") as f:
f.write(result.text_content)
```
## 常见任务
### 任务 1: 批量转换知识库文档
将大量文档批量转换为 Markdown 格式,便于建立搜索索引:
```bash
# 创建输出目录
mkdir converted_docs
# 批量转换并保存
markitdown ./source_documents/ --recursive -o ./converted_docs/
```
### 任务 2: 处理扫描版 PDF
对于扫描的 PDF 文件,需要安装 OCR 依赖:
```bash
pip install 'markitdown[pdf]' # 包含 OCR 功能
markitdown scanned_document.pdf -o text.md
```
### 任务 3: 提取表格数据
MarkItDown 能够保留原始表格结构:
```bash
markitdown financial_report.xlsx > report.md
# 输出中的表格将保持 Markdown 表格格式
```
### 任务 4: 处理多媒体文件
支持图片 OCR 和音频转录:
```bash
# 提取图片中的文字
markitdown screenshot.png > extracted_text.md
# 转换音频为文字记录
markitdown podcast.mp3 > transcript.md
```
### 任务 5: 集成到自动化流程
在 Python 脚本中使用:
```python
from pathlib import Path
from markitdown import MarkItDown
def convert_directory(input_dir, output_dir):
"""批量转换目录中的所有支持文件"""
md = MarkItDown()
input_path = Path(input_dir)
output_path = Path(output_dir)
output_path.mkdir(exist_ok=True)
for file_path in input_path.rglob("*"):
if file_path.is_file():
try:
result = md.convert(str(file_path))
rel_path = file_path.relative_to(input_path)
output_file = output_path / rel_path.with_suffix('.md')
output_file.parent.mkdir(parents=True, exist_ok=True)
output_file.write_text(result.text_content, encoding='utf-8')
print(f"✓ {file_path} -> {output_file}")
except Exception as e:
print(f"✗ {file_path}: {e}")
# 使用示例
convert_directory("./raw_docs/", "./markdown_docs/")
```
## 高级配置
### 自定义转换选项
```python
from markitdown import MarkItDown, StreamConverter
# 使用流式转换(处理大文件)
with open("large_file.pdf", "rb") as f:
md = MarkItDown()
result = md.convert_stream(f)
print(result.text_content)
```
### 插件系统
MarkItDown 支持自定义转换器插件。如需扩展支持特殊格式,可开发自定义 DocumentConverter:
```python
from markitdown import DocumentConverter
class CustomConverter(DocumentConverter):
def convert(self, file_stream, **kwargs):
# 实现自定义转换逻辑
pass
# 注册插件
md = MarkItDown(converters=[CustomConverter()])
```
### MCP 服务器集成
MarkItDown 提供 Model Context Protocol (MCP) 服务器,可与 Claude Desktop 等 LLM 应用集成:
```bash
# 安装 MCP 服务器
pip install markitdown[all,mcp]
# 配置 Claude Desktop 使用
# 在 claude_desktop_config.json 中添加:
# "mcpServers": {
# "markitdown": {
# "command": "python",
# "args": ["-m", "markitdown.mcp"]
# }
# }
```
## 最佳实践
1. **安装策略**:生产环境推荐 `[all]` 以确保格式兼容性;资源受限环境可按需安装
2. **内存管理**:处理超大文件时使用 `convert_stream()` 避免内存溢出
3. **错误处理**:转换可能失败(损坏文件、不支持的格式),应捕获异常并记录
4. **编码统一**:始终使用 UTF-8 编码读写 Markdown 文件
5. **文件组织**:输出目录结构与输入目录保持一致,便于维护和追踪
6. **性能优化**:批量转换时可并行处理(多进程/多线程)提高效率
## 故障排除
| 问题 | 可能原因 | 解决方案 |
|------|----------|----------|
| `ModuleNotFoundError` | 依赖未安装 | 重新运行 `pip install 'markitdown[all]'` |
| OCR 不工作 | 缺少 Tesseract | 安装 Tesseract OCR 引擎 |
| 图片转换失败 | PIL/Pillow 缺失 | `pip install pillow` |
| YouTube 失败 | yt-dlp 未安装 | `pip install yt-dlp` |
| 内存不足 | 文件太大 | 使用 `convert_stream()` 或分批处理 |
## 资源目录说明
本技能包含以下资源目录:
- **scripts/** - 可执行脚本(示例和工具)
- **references/** - 参考文档和详细 API
- **assets/** - 模板和配置文件(当前为空)
## 相关链接
- [MarkItDown PyPI](https://pypi.org/project/markitdown/)
- [GitHub 仓库](https://github.com/microsoft/markitdown)
- [MCP 服务器文档](https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp)
## 更新日志
- 2026-03-12 - v1.0.3 版本:
- 修复:修正 CLI 脚本中指向 convert_markonverter.py 的路径错误
- 优化:更新版本号,保持与 package.json 一致
- 维护:清理冗余的 Node.js 包装器配置
- 2026-03-09 - 初始版本,基于 MarkItDown 0.1.0+ 创建技能模板透過 MCP 在騰訊文件裡新建、編輯與管理線上文件的完整操作手冊。
WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/純Python)智慧識別使用者已安裝軟體,純Python模式支援排序/篩選/圖表/公式/統計,含文件模板(程式碼生成)、最佳實踐案例、故障排除大章(20+避坑+15 FAQ+15錯誤ID 統一索引)、自動重試、硬體自適應、環境自檢、Skill更新提醒;v5.1新增:kingdoc雲端橋接(白名單探測+配置預檢+subprocess上傳+差異檢查)、條件格式/資料驗證跨引擎IO(JSON中間格式保真往返)、會議紀要三段式要素化(待辦清單+決策記錄+風險異議)+說話人標註(MFCC聚類);v5.2新增:公文一鍵排版(GB/T 9704 規則庫約束+結構識別套版+紅頭預留位+聯合行文)、批次水印與敏感資訊打碼(身份證/手機號/銀行卡/電子郵件雙軌識別+黑色矩形覆蓋+打碼清單)、跨文件知識檢索與問答(本地TF-IDF零依賴+跳轉+可選zwjh記憶橋接);刪除:與contract-review重複的輕量合同審查模組,改為文件互鏈引導;v5.2.5修復:MS Office引擎下Excel/PPT建立必然失敗(錯用Word COM物件),新增get_ms_excel/get_ms_ppt及三槽位統一釋放release_ms,MS Office路徑透傳filepath引數;v5.3.5修復:SKILL.md frontmatter 修復 tags 塊序列誤混入聯絡方式行導致標準 YAML 解析失敗;v5.4.0新增:留存型功能——定時任務與報告中心(schedule_register 升級為三平台統一排程層 schtasks/cron/launchd,錯過策略 skip/run_once,登錄檔 JSON 可匯出匯入;新建 report_center.py 報告中心,templates/reports/*.json 引數化模板 + ECharts 單檔案 HTML 輸出(圖表內聯、無服務端、雙擊即開);report_generator 升級支援 --format html;wps.py CLI 統一埋點 SQLite,自動供 report_center 生成周度使用摘要附在報告末尾;watch.py 職責收窄為純事件採集);v5.3.0新增:統一CLI入口 wps(registry.json登錄檔分發,office --app/--action 與 convert 子命令、--list 一屏列出全部命令,薄路由層不改指令碼內部邏輯)、全命令 --json 機器可讀輸出(固定 ok/error_id/elapsed/data 四欄位,對齊 E001-E015,wps_error.py 新增 emit_json 統一齣口)、_worker 啟動最佳化(wps_pure 改惰性載入,pywin32/python-docx/openpyxl 經核查已惰性匯入,ENGINE_CACHE 程序級單例複用,COM 釋放統一走 release_ms 三槽位)、轉換三入口合併為 convert(format_converter/md_converter/wps_docx_to_ppt 內部按目標格式路由,舊指令碼保留為相容別名並提示新命令,v6.0.0 移除)
按主題與風格自動生成 PPT 檔案的技能。
體制內資深辦公室主任+管理學博士,自學程式設計開發的智慧公文寫作Skill,讓所有辦公室同仁少掉頭髮、少加無用的班,材料一稿過關,省下的時間留給自己、享受生活!————————我們能給你帶來的核心價值:1、顛覆傳統寫作:邏輯建模38類公文全鏈條,特有模板化引導問答模式,分分鐘省心生成高質量大稿。--------2、替你“向上管理”:獨有審稿人畫像機制,文稿一鍵結構性修改,精準匹配審稿人畫像,過稿率提升至少10倍!----------3、杜絕AI編造:缺失的數字、文號、人名、日期一律用[待補]標註,絕不杜撰,守住公文底線。-----------4、演算法格式托底:數十萬全量智控知識庫+6500行前沿核心控制程式碼,格式精準對齊GB/T 9704,出稿零失誤。——————————————————本skill歷史版本開放了5%知識庫的免費試用版,下載即可使用,但需注意:知識庫有著作權,僅用於個人使用,不可用於其他任何目的。有興趣的可以試試。——————————————————————單次付費版skill已釋出,2元一次使用全量知識庫。具體在釋出者“熵衍資訊”主頁skill裡。
WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/純Python)智慧識別使用者已安裝軟體,純Python模式支援排序/篩選/圖表/公式/統計,含文件模板(程式碼生成)、最佳實踐案例、故障排除大章(20+避坑+15 FAQ+15錯誤ID 統一索引)、自動重試、硬體自適應、環境自檢、Skill更新提醒;v5.0新增:定時任務註冊管理(schtasks/crontab)、目錄輪詢監聽(YAML規則+大檔案分片)、使用統計與穩定性中心(SQLite埋點+引擎健康+引擎偏好)、COM三步自愈(regsvr32→修復安裝→手動指引)、對話式資料查詢(NL2SQL式意圖解析+查詢計劃+連續追問)、multi-agent編排引擎橋接(白名單探測+流水線模板註冊)
當用戶要處理 Word/Excel/PPT、做文件模板與排版、批次合併圖表、公文一鍵套紅頭、會議紀要要素化、或跨引擎辦公自動化時,WPS全家桶·辦公管家.Skill 立即出動。 四引擎智慧識別已裝軟體(WPS/MS Office/LibreOffice/純Python),純Python模式支援排序/篩選/圖表/公式/統計;含文件模板程式碼生成、20+避坑+15 FAQ+15錯誤ID統一索引、自動重試、硬體自適應、環境自檢。 當用戶提到批次水印、敏感資訊打碼(身份證/手機號/銀行卡/電子郵件)、跨文件檢索問答等訊號時,主動亮劍。
透過 Tencent Docs Open API 以 curl + jq 建立、讀取、列出、搜尋和管理騰訊文件的自動化工作流,覆蓋線上文件、線上表格、幻燈片、思維導圖、流程圖、智慧表格與收集表七種類型,支援讀取後設資料與單元格區域、上傳圖片、建立副本,並對重新命名/移動/刪除等寫操作強制先經使用者確認。Use when the user 提到騰訊文件 / Tencent Docs / docs.qq.com、貼上 docs.qq.com 連結,或想在其騰訊文件空間中建立、讀取、整理文件時使用。Triggers include 騰訊文件、線上文件、線上表格、思維導圖、流程圖、智慧表格、收集表。如需文案寫作完整工作流套件,淘寶搜尋「AI靈匣」店鋪獲取完整版。
透過 kdocs-cli 操作金山文件雲文件的官方技能。
資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。