使用 markitdown 将各种文件格式转换为 Markdown
本 skill 提供以下 Python 脚本:
convert_file.py - 转换单个文件为 Markdownbatch_convert.py - 批量转换多个文件convert_with_llm.py - 使用 LLM 增强图片描述(可选)环境要求:
setup.sh 确保虚拟环境已创建并激活requirements.txt 中定义ffmpeg(可选,macOS: brew install ffmpeg)支持的文件格式:
可选功能:
输出说明:
错误处理:
在使用任何脚本前,必须先运行:
bash setup.sh
这个脚本会:
环境准备完成后,可以使用以下脚本:
python convert_file.py --input document.pdf --output output.md
参数说明:
--input: 输入文件路径(必需)--output: 输出 Markdown 文件路径(可选,默认输出到终端)--enable-plugins: 启用第三方插件(可选)python batch_convert.py --input-dir ./documents --output-dir ./markdown --pattern "*.pdf"
参数说明:
--input-dir: 输入目录路径(必需)--output-dir: 输出目录路径(必需)--pattern: 文件匹配模式(可选,默认为所有文件)--recursive: 递归处理子目录(可选)python convert_with_llm.py --input image.jpg --output output.md --api-key YOUR_API_KEY
参数说明:
--input: 输入文件路径(必需)--output: 输出文件路径(可选)--api-key: OpenAI API Key(必需)--model: LLM 模型(可选,默认 gpt-4o)python convert_file.py --input document.pdf --output output.md --azure-endpoint YOUR_ENDPOINT
cat document.pdf | python convert_file.py > output.md
如果需要使用音频转录功能,请先安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt-get install ffmpeg
然后转换音频文件:
python convert_file.py --input audio.mp3 --output transcript.md
As 文件转换工具, you must follow the above Rules and execute tasks according to Workflows. 在使用任何功能前,必须先运行 setup.sh 确保环境正确配置。