Claude Code 和 Codex 学术文档转 Markdown 技能：sanmu-doc2md

Claude Code、Codex 安装步骤

下载本页固定提交的仓库归档，取出 skills/sanmu-doc2md/ 整个目录，保留 SKILL.md、scripts/、references/ 和 requirements.txt。
在 Claude Code 中将目录放到 ~/.claude/skills/，在 Codex 中放到 ~/.agents/skills/。从技能目录运行 python scripts/doctor.py 查看环境。
如需完整的转换和校验功能，在专用虚拟环境中用 python -m pip install -r requirements.txt 安装 Python 依赖，再执行 npm --prefix scripts install --ignore-scripts --no-audit --no-fund 安装 KaTeX。已有 OCR 文件时直接跳过云端凭证配置。

中文摘要

将教材、课件和论文整理成按章节组织的 Markdown，保留 LaTeX 公式、图表与来源页码。已有 OCR 结果时可在本地装配，适合整理供 Obsidian 阅读的学术资料。

SKILL.md 中文导读

可复现示例

在技能目录新建 demo-raw/lesson-01，将以下虚构的 OCR 内容保存为 demo-raw/lesson-01/content_list.json：

[{"type":"text","text":"Demo lesson: a square has four sides.","page_idx":0,"bbox":[72,72,420,110]},{"type":"equation","text":"A = s^2","page_idx":0,"bbox":[72,134,260,172]}]

然后在技能目录运行：

python scripts/build_markdown.py --raw ./demo-raw --out ./demo-notes --mode slides

工作步骤

判断输入是教材、课件还是论文。已有 MinerU OCR 结果时，可直接使用整理脚本。
从原文校对公式、图题及页码，确认后将已整理的 Markdown 写入新的目录。

验收方法

demo-notes/lesson-01.md 应包含示例句与公式 A = s^2，demo-notes/00-目录.md 应链接到该文件。这个例子验证本地 Markdown 装配部分，未提交云端 OCR。

GitHub 原文 · 更新日期 2026-11-15

适用环境

单独安装用 Python 3.10 或以上版本。公式校验和本地预览需要 Node.js 22.20 或以上及 KaTeX。只有使用 MinerU 云端 OCR 时才需要网络和 MINERU_API_TOKEN。

常见问题

已有 MinerU 的 content_list.json 时还需要配置 Token 吗？

读取现有 OCR 结果并装配 Markdown 不需要 MinerU Token。需要从未识别的扫描件新建云端 OCR 批次时，再按仓库文档配置凭证。