让 Codex 读取 PDF

如果当前工具能直接读取 PDF 并完成任务,直接使用即可。需要扫描件 OCR 或可复用的 Markdown 时,再进行转换。

当前会话需要 Node 18+ 和网络连接。演示无需注册。

演示仅转换第 1 页。 转换会将文档发送至外部服务。请遵守文档处理授权。

terminal
$ npx pdftomarkdown@0.1.6 document.pdf

对照源 PDF 与完整 Markdown 输出(英文)

请预留最多 11 分钟。停止客户端后,服务端处理和计费仍可能继续。 CLI 设置与恢复指南(英文)

转换完整文档

新账户一次性获赠 20 页试用额度,支持完整多页输出且无水印。之后使用付费额度。通过 GitHub 获取 API 密钥,再设置环境变量。

GitHub 获取 API 密钥(英文) →

shell profile
export PDFTOMARKDOWN_API_KEY=your_key_here

CLI 会自动从环境变量读取密钥。

可选:将流程写入 AGENTS.md

将以下说明添加到项目的 AGENTS.md 或 ~/.codex/AGENTS.md。仍需确认可用工具和文档处理授权。

AGENTS.md
## 读取 PDF

能否直接处理 PDF 取决于本次会话可用的工具。
需要 OCR 或可复用的 Markdown 时再转换。文档将发送至外部服务,
请遵守用户对文档处理的授权。使用 Node 18+ 和已发布的 CLI:

    npx pdftomarkdown@0.1.6 document.pdf

长文档请分段读取输出。演示仅转换第1页;新账户一次性获赠20页,
之后使用付费额度。未经用户明确授权,不得购买额度。
同步请求可等待最多11分钟;停止等待后,服务端处理和计费仍可能继续。
不同版本的恢复操作请参阅 https://pdftomarkdown.dev/docs/cli/。