📚 Markitdown
由微软开源的 Python 工具，用于将多种文件格式转换为 Markdown 格式
支持：PDF、PowerPoint、Word、Excel、图像、音频、HTML、文本格式（CSV、JSON、XML）、ZIP 文件的转换。
它旨在提供一个简单且灵活的解决方案，以便在您的应用程序中轻松集成 Markdown 渲染功能。
🌟 核心功能
-
多格式支持 : 一键转换 PDF/PPT/Word/Excel/图像/音频/HTML 等12+格式
-
智能处理:
-
图像 OCR文字识别 (支持中文扫描件)
-
音频 语音转文字 (支持英文优先)
-
集成 GPT-4o 生成图像描述
-
开发者友好: 提供Python API及Docker部署方案
🚀 特性
-
轻量级：小巧的库，易于集成。
-
快速：高效的 Markdown 解析和渲染。
-
可扩展：支持自定义插件和扩展功能。
-
易于使用：简单的 API，快速上手。
🔧 典型应用场景
- 文档归档: 批量转换Office文件为Markdown
- 知识库构建: 整合OCR文本+语音转录内容
- 自动化流程: 结合CI/CD实现文档发布流水线
🛠️ 快速安装
bash
# 基础安装 (Python 3.10+)
pip install markitdown[all]或从源码安装
bash
git clone https://github.com/microsoft/markitdown
cd markitdown
pip install -e .🛠️ 使用
📖 使用示例
命令行工具
bash
# 转换PDF到Markdown
markitdown input.pdf -o output.md
bash
# 管道操作
cat input.docx | markitdown > output.md
bash
或者使用-o指定输出文件：
markitdown path-to-file.pdf -o document.md可选依赖项
MarkItDown 有可选的依赖项用于激活各种文件格式。在本文档的前面，可以使用 all 选项安装了所有可选依赖项。当然，您也可以单独安装它们以获得更多的控制权。
例如：
c
pip install 'markitdown[pdf, docx, pptx]'将仅安装PDF、DOCX和PPTX文件所需的依赖项。
目前，以下可选依赖项可用：
- all安装所有可选依赖项 pptx为PowerPoint文件安装依赖项
- docx为Word文件安装依赖项
- xlsx为Excel文件安装依赖项
- xls为旧的Excel文件安装依赖项
- pdf为PDF文件安装依赖项
- outlook为 Outlook 消息安装依赖项
- az-doc-intel安装 Azure 文档智能所需的依赖项
- audio-transcription安装用于WAV和MP3文件音频转录的依赖项
- youtube-transcription安装获取 YouTube 视频字幕所需的依赖项
插件
MarkItDown 还支持第三方插件。插件默认禁用。
以下操作可列出已安装的插件：
c
markitdown --list-plugins启用插件使用：
c
markitdown --use-plugins path-to-file.pdf要查找可用的插件，请在GitHub上搜索该标签#markitdown-plugin。
Azure 文档智能
要使用 Microsoft 文档智能进行转换：
c
markitdown path-to-file.pdf -o document.md -d -e "<document_intelligence_endpoint>"Python 应用程序编程接口
在 Python 中的基本用法：
c
from markitdown import MarkItDown
md = MarkItDown(enable_plugins=False) # Set to True to enable plugins
result = md.convert("test.xlsx")
print(result.text_content)Python中的文档智能转换：
c
from markitdown import MarkItDown
md = MarkItDown(docintel_endpoint="<document_intelligence_endpoint>")
result = md.convert("test.pdf")
print(result.text_content)要使用大语言模型进行图像描述，请提供 llm_client 和 llm_model:
c
from markitdown import MarkItDown
from openai import OpenAI
client = OpenAI()
md = MarkItDown(llm_client=client, llm_model="gpt-4o")
result = md.convert("example.jpg")
print(result.text_content)📚 运行测试和检查
导航到 MarkItDown 包：
c
cd packages/markitdown安装 hatch 在您的环境中并运行测试：
c
pip install hatch # Other ways of installing hatch: https://hatch.pypa.io/dev/install/
hatch shell
hatch test（替代方案）使用已安装所有依赖项的Devcontainer：
c
Reopen the project in Devcontainer and run:
hatch test在提交 PR 之前运行预提交检查：pre-commit run --all-files
5、每日资源 在这里
💯 👉【我的更新汇总】
👉项目直达
关注我的CSDN博客
更多资源可以查看我的CSDN博客