Markdown Everything

markdown-everything

将 PDF、Word、Excel、PPT、图片、音频等 20+ 种文档格式转换为 Markdown，让 AI Agent 能直接读取文档内容。

触发条件

当用户要求以下操作时调用此技能：

• 将文档转换为 Markdown
• 读取/提取文档内容
• 批量处理文档
• 处理中文 PDF 乱码

注意：如果用户只是问"怎么用 markitdown"，先回答问题，不要直接触发转换。

支持的格式

使用方法

第一步：环境准备

首次使用需安装依赖。根据操作系统选择对应命令：

Windows (PowerShell)：

pip install "markitdown[all]"
pip install pdfplumber

如果使用 Conda：

conda create -n markitdown python=3.12 -y
conda activate markitdown
pip install "markitdown[all]"
pip install pdfplumber

Linux / macOS：

pip install "markitdown[all]"
pip install pdfplumber

如果使用 Conda：

conda create -n markitdown python=3.12 -y
conda activate markitdown
pip install "markitdown[all]"
pip install pdfplumber

国内用户可使用镜像加速：

pip install "markitdown[all]" -i https://pypi.tuna.tsinghua.edu.cn/simple

第二步：转换文档

基本转换：

python SKILL/markdown-everything/scripts/convert_document.py "输入文件.pdf" -o "输出.md"

或直接使用 markitdown CLI：

markitdown "输入文件.docx" -o "输出.md"

Windows PowerShell 用户注意：不要使用 && 链接命令，请用分号 ; 或分行：

# 正确：分号链接
conda activate markitdown; markitdown "文档.pdf" -o "输出.md"

# 正确：分行
conda activate markitdown
markitdown "文档.pdf" -o "输出.md"

# 错误：&& 在部分 PowerShell 版本不可用
conda activate markitdown && markitdown "文档.pdf" -o "输出.md"

PDF 中文文档特殊处理

PDF 文件会自动使用 pdfplumber 进行 Unicode 字符级提取，解决中文乱码问题。如果自动处理失败，会回退到标准 markitdown 转换。

高级选项

# JSON 格式输出
python SKILL/markdown-everything/scripts/convert_document.py "文档.docx" --json-output

# 详细日志
python SKILL/markdown-everything/scripts/convert_document.py "文档.docx" --verbose

# LLM 增强（需设置 OPENAI_API_KEY 或 ANTHROPIC_API_KEY）
python SKILL/markdown-everything/scripts/convert_document.py "文档.docx" --llm-client openai --llm-model gpt-4o -o "输出.md"

批量转换

Windows PowerShell：

Get-ChildItem "C:\Documents\*.docx" | ForEach-Object {
    markitdown $_.FullName -o "$($_.DirectoryName)\$($_.BaseName).md"
}

Linux / macOS：

for f in /path/to/docs/*.docx; do
    markitdown "$f" -o "${f%.docx}.md"
done

故障排除

转换失败

输出格式问题

环境问题

环境变量

注意事项

• 首次使用会自动检测并安装依赖
• PDF 中文文档优先使用 pdfplumber 处理
• 大文件转换可能需要较长时间
• LLM 增强功能需要 API Key
• 输出文件默认保存在输入文件同目录
• Windows 用户：路径中包含空格时，用引号包裹路径