前言¶
教材讲义、论文附录、作业扫描件常以 PDF 形式流转。里面若有大量数学公式和表格，直接复制到 Word 往往乱版，公式变成图片或乱码，后续批改、摘录、二次排版成本很高。常见做法是手工重打公式，或借助通用 PDF 转 Word 工具，但对扫描版、公式密集文档，效果经常不稳定。
下面介绍 SkillHub 上的「数学公式pdf转可编辑word格式」Skill。它面向扫描版数学 PDF，目标是把内容整理成排版相对整洁的 Word，并尽量保留公式（OMML）和表格结构，转换链路依赖 MinerU、Pandoc 与 python-docx。本文事实来自任务提供的 Skill 简介与 SkillHub 公开指标；撰写时 https://api.skillhub.cn/user_1627842f/pdf-toord 无法通过 GET 拉取详情（HTTP 405），具体安装话术请以 SkillHub 官方地址为准。
这是什么¶
「数学公式pdf转可编辑word格式」是发布在 SkillHub 的 Agent Skill，官方入口为：
https://api.skillhub.cn/user_1627842f/pdf-toord
在 SkillHub 分类为 office-efficiency，社区评分为 97783，下载量 862 次（数据随 SkillHub 更新而变化）。
一句话定位：让支持 Skills 的编码 Agent 按 SKILL.md 中的流程，把扫描版数学 PDF 转成可编辑的 .docx，而不是只产出纯图片页或丢失公式结构的粗糙文档。
核心功能¶
结合 Skill 简介，目前可确认的能力如下。
- 输入：扫描版数学 PDF（含公式、表格的版面）。
- 输出：Word 文档（
.docx），强调整体排版可读、便于后续编辑。 - 公式：以 Word 原生 OMML（Office Math Markup Language）形式保留，便于在 Word 内继续改公式，而不是整页贴图。
- 表格：尽量保留表格结构，避免转完后表格塌成纯文本流。
- 技术栈：Skill 说明中明确依赖 MinerU（文档解析与版面/公式识别）、Pandoc（格式转换链路中的一环）、python-docx（对 Word 文档进行生成或后处理）。
Skill 本身不替代这三个组件的安装与授权配置；它主要是把「解析 → 转换 → 生成 docx」的步骤写进 Agent 可执行的说明里，减少你每次口述流程的负担。
安装与启用¶
这类 Skill 通常遵循通用 SKILL.md 格式：仓库或压缩包内有一份说明，Agent 读取后按步骤调用本机或已配置环境中的工具。
由于官方 API 地址当前无法直接抓取安装命令，建议按下面顺序操作，避免与页面不一致：
- 在浏览器打开 SkillHub 上的技能页（与官方地址同一技能 ID 的展示页，例如
https://skillhub.cn/skills/user_1627842f/pdf-toord），查看是否提供「复制给 Agent 的安装话术」或 CLI 安装说明。 - 将页面给出的安装话术发给 Cursor、Codex CLI、Claude Code 等已启用 Skills 的 Agent，由 Agent 完成 Skill 落盘与目录配置。
- 在本机或 Agent 运行环境中提前准备 Skill 简介列出的依赖，至少包括：
- MinerU：用于 PDF 解析、扫描件 OCR、公式识别等（参见 OpenDataLab MinerU 官方文档安装 CLI 或 API）。
- Pandoc：用于文档格式转换，需保证pandoc在 PATH 中可用。
- python-docx：Python 包，用于读写.docx；一般通过pip install python-docx安装（具体版本以 SKILL.md 或 Agent 执行日志为准）。
不同 Agent 对 Skills 的目录名、环境变量名可能略有差异；以 SkillHub 页面与解压后的 SKILL.md 为准，本文不列举未经页面核实的配置项。
典型用法¶
官方详情页本次未能抓取到逐步示例，下面是根据 Skill 简介整理的预期工作方式，实际命令与参数以安装后的 SKILL.md 为准。
- 准备输入：将待转换的扫描版数学 PDF 放在 Agent 可访问的路径，或按 SKILL.md 要求上传/指定文件。
- 触发 Skill：在对话中说明需求，例如需要将某 PDF 转为可编辑 Word、且需保留公式与表格；并引用已安装的「数学公式pdf转可编辑word格式」Skill（名称以 SkillHub 展示为准）。
- 解析阶段（MinerU）：Agent 按 Skill 调用 MinerU，对 PDF 做版面分析；扫描件会走 OCR，公式通常会被识别为可再加工的表示（如 LaTeX 等中间形态，具体以 MinerU 输出为准）。
- 转换与生成（Pandoc + python-docx）：在中间结果基础上生成
.docx，并把公式写入 OMML、表格写入 Word 表格结构；必要时用 python-docx 微调段落或样式。 - 验收：在 Microsoft Word 或兼容 OMML 的套件中打开输出文件，检查公式是否可编辑、表格是否对齐、分页是否合理；有问题时把样例页反馈给 Agent，按 SKILL.md 中的排错建议迭代。
若你已有 MinerU 使用经验，可把本 Skill 理解为把「数学扫描 PDF → 结构化中间稿 → 带 OMML 的 docx」固化成 Agent 可重复执行的剧本，而不是每次从零写脚本。
适用场景与注意¶
更适合
- 需要从扫描 PDF 得到可改动的 Word 讲义、习题、附录。
- 文档以数学公式和表格为主，希望在 Word 里继续改公式而不是修图。
- 愿意在本地或指定环境安装 MinerU、Pandoc、Python 生态，并接受多步转换的耗时。
限制与注意
- 依赖环境：三者任一未安装或版本不匹配，转换可能失败或降级为纯文本/图片；安装前先看 SKILL.md 与 MinerU 官方要求（GPU/CPU、OCR 语言等）。
- 扫描质量：模糊、倾斜、手写过多的页面会影响 OCR 与公式识别，输出仍需人工校对。
- 公式复杂度：极复杂公式、特殊符号、混排图公式，OMML 还原程度取决于 MinerU 识别与后续转换规则，不能等同于「与原 PDF 像素级一致」。
- 官方信息获取：若 SkillHub 页面显示技能下线或 API 不可用，需联系发布者或改用 SkillHub 上同类的 office-efficiency 技能；下载量与评分仅作选型参考，不代表单次转换质量。
结尾¶
「数学公式pdf转可编辑word格式」把扫描版数学 PDF 转 Word、保留 OMML 公式与表格结构这件事，收敛成 Agent 可执行的 Skill，并明确依赖 MinerU、Pandoc 与 python-docx。若你经常处理这类文档，值得在 SkillHub 查看说明并安装到常用 Agent 里试跑一份样例 PDF。
官方地址：https://api.skillhub.cn/user_1627842f/pdf-toord
