markpdfdown

上传PDF，大模型帮你转成干净Markdown

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 188 🐛 待处理 7 👀 关注 12

GitHub ↗

GitHub 星标 ★ 2317

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，Apache-2.0许可证，可免费自行部署使用。

项目预览

markpdfdown 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开源模型

开发团队MarkPDFdown

GitHubhttps://github.com/MarkPDFdown/markpdfdown

定价模式🏷️完全免费

价格说明开源项目，Apache-2.0许可证，可免费自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型llm,markdown,pdf,pdf-converter,pdf-markdown,pdf2markdown,pdf2md

GitHub 星标★ 2317

上线时间2025-03-14 00:00:00

代码更新2026-09-23

仓库体积10.0 MB

本站数据更新2026-11-07

维护状态维护中

收录时间2026-08-09

浏览次数6

项目介绍

markpdfdown 是一款基于大模型视觉识别的高质量 PDF 转 Markdown 工具。它利用多模态大模型（如 GPT-4V 等）对 PDF 页面进行视觉解析，将复杂排版（如表格、公式、多栏、图片）转换为结构清晰的 Markdown 格式，解决了传统 PDF 解析工具在复杂文档上准确率低、格式丢失的问题。核心能力包括：高精度识别文本和结构、保留表格与公式、支持批量处理、提供简单易用的 API 和命令行界面。项目使用 Python 开发，依赖大模型 API，适合需要将扫描版 PDF 或复杂排版 PDF 转换为可编辑 Markdown 文档的开发者、研究人员和内容创作者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2317

技术标签

llm markdown pdf pdf-converter

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Python 环境（pip 可用于安装依赖）
uv 包管理器（README 推荐方式，可选）
Docker（仅在容器方式下需要）
Node.js / npx（仅在启动桌面应用时需要）
OpenAI 或 OpenRouter 的大模型 API Key

安装与启动步骤

1获取项目源码

从 GitHub 克隆 markpdfdown 仓库，后续安装与配置命令都在该目录内执行。
```
git clone https://github.com/MarkPDFdown/markpdfdown.git
```
2安装 uv 工具

README 推荐使用 uv 管理依赖；若已安装可跳过此步。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
3安装项目依赖

用 uv 同步依赖创建虚拟环境，再以开发模式安装本包；不用 uv 时可用 pip 命令。
```
uv sync
uv pip install -e .
```
4配置环境变量

先复制示例配置，再编辑 .env 填入模型名和 API Key 等信息。
```
cp .env.sample .env
```
5Docker 方式转换

无需本地 Python 环境，通过标准输入传入 PDF，结果重定向写入 Markdown 文件。
```
docker run -i -e MODEL_NAME=gpt-4o -e OPENAI_API_KEY=sk-xxxxxxxx markpdfdown < input.pdf > output.md
```
6启动桌面应用

想要图形界面时，用 npx 直接运行官方桌面应用，无需手动安装依赖。
```
npx -y markpdfdown
```

关键配置

配置项	必填	说明	示例
`MODEL_NAME`	是	指定用于视觉解析 PDF 的多模态大模型名称	`gpt-4o`
`OPENAI_API_KEY`	是	调用大模型所需的 API 密钥，缺失将无法转换	`sk-xxxxxxxx`