核心用法
pdf2md 是封装 MinerU 开源能力的 CLI 工具，通过 mineru-open-api flash-extract 命令将 PDF 文档转换为结构化 Markdown。支持本地文件与远程 URL 双模式，无需注册或 API Key，单文档上限 10MB/20 页。进阶需求可通过 extract 子命令处理 200MB/600 页大文件，但需完成身份认证。
显著优点
- 零门槛接入：无需账号体系，安装即用，降低临时性文档处理成本；
- 多源支持：本地路径与 HTTP(S) URL 直接解析，省去下载步骤；
- 精确控制：支持页码范围 (
--pages) 与语言提示 (--language)，优化中文/英文混排场景； - 学术友好：公式与表格保留占位符，适合科研论文、技术报告的半自动化整理。
潜在局限
- 输出不完整：图片、复杂表格、公式仅生成占位符，非可视化还原；
- 容量严格受限：免费层 10MB/20 页难以应对书籍、年报等大型文档；
- 隐私风险：文件需上传至 MinerU 服务端处理，敏感商业或机密文档存在外泄隐患；
- 依赖网络：纯云端解析，离线环境或网络受限场景不可用。
适合人群
知识工作者、研究人员、开发者——需快速将 PDF 论文、手册、报告转为可编辑 Markdown，但对版式还原要求不高，且文档不含高度敏感信息。
常规风险
1. 数据主权：PDF 内容传输至第三方服务器（mineru.net），跨境合规需自行评估；
2. 解析误差：扫描版 PDF、复杂排版或手写内容识别准确率下降；
3. 服务连续性：免费无认证接口存在速率限制或策略调整可能，生产环境建议备选方案。