数学练习题 PDF 生成器(LaTeX/KaTeX):把题集一次排版成 PDF

前言

做数学题集、试卷、作业集,最耗时间的往往不是选题,而是排版。公式要用 LaTeX 语法写,写错一个符号整段就不渲染;章节要分类,封面要单独做;最后还要从文本源生成 PDF。手工做这一套,改一次题目结构就要重排一遍。

这个 Skill 把上面这些步骤收进一次生成流程:你给出题目内容和结构,它负责公式排版、封面和章节组织,最终产出 PDF。下面介绍它的定位、能力边界和用法。

这是什么

一句话定位:一个面向考研数学场景的 PDF 生成技能,用统一流程把数学练习题、试卷、作业集排版成 PDF 文档。

基本信息如下:

  • Skill 名称:数学练习题 PDF 生成器(LaTeX/KaTeX)
  • 坐标:@user_ce094de0/math-exercise-pdf
  • 版本:1.0.0
  • 来源:community
  • 分类:education
  • 发布者:user_ce094de0
  • 标签:requires_api_key=false(调用不需要额外的 API Key)

它解决的核心问题是:让题目内容与排版分离,公式语法有防错约束,输出前有自检脚本,减少来回返工。

核心功能

下面列出的能力均来自该 Skill 的官方简介。

1、完整的 LaTeX 数学公式排版,题目里的公式、上下标、分式、积分等按 LaTeX 语法渲染。
2、封面设计,可以给生成的 PDF 加上封面页。
3、分类章节结构,按章节组织题目,形成成册的练习集或试卷。
4、内置公式语法防错规则,在生成阶段对公式写法做约束,避免明显的语法错误带进输出。
5、内置自检脚本,生成后用于检查产物。

触发时机:当需要创建数学练习题、考试试卷、数学作业集等 PDF 文档时使用此技能。

两种输出方式

这个 Skill 提供两条产出 PDF 的路径,按环境选一条即可。

方式一:HTML + KaTeX(Playwright 渲染,官方推荐)

先把题目内容组织成 HTML,数学公式用 KaTeX 语法书写,再用 Playwright 渲染为 PDF。

这条路线的优点是渲染在浏览器内核里完成,不需要本地安装 LaTeX 编译环境;缺点是需要可用的 Playwright 环境。官方将其列为推荐方式。

方式二:LaTeX(xelatex 编译)

先把内容写成 LaTeX 源文件,再用 xelatex 编译成 PDF。

这条路线适合已有 LaTeX 环境的使用者,排版控制力更强;代价是本地要装好 xelatex 工具链。

两种方式的输入都是题目内容与章节结构,区别在于公式渲染和 PDF 产出的实现。

安装与启用

安装命令在抓取资料中没有给出,本节不臆造。可确认的事实是:

  • 该 Skill 遵循通用 SKILL.md 格式,通过 SkillHub 分发,坐标为 @user_ce094de0/math-exercise-pdf。
  • 标签 requires_api_key=false,说明启用时不需要配置 API Key。
  • 在 Cursor、Codex CLI、Claude Code 等不同客户端里,SKILL.md 类 Skill 的安装入口和调用方式并不统一;本 Skill 的官方页面未说明各客户端的差异,因此以官方页面为准。

拿到 Skill 文件后,按所用客户端的 SKILL.md 放置方式放入 Skill 目录,在对话中说明你要生成的题目内容、章节结构、封面需求和输出方式即可。

典型用法

可复现的完整命令没有出现在抓取资料中,下面给出的是按官方简介可以确认的使用流程。

1、明确需求。说明用途是练习题、试卷还是作业集,给出章节划分,例如按知识模块分章,再说明每章题目数量。
2、确认输出方式。环境里有 Playwright 就用 HTML + KaTeX;只有 xelatex 就用 LaTeX 编译路径。
3、提供题目内容。题目文本加公式,公式按 LaTeX / KaTeX 语法书写。这一步会受内置防错规则约束。
4、生成并自检。生成封面、章节和公式,运行自带的自检脚本确认产物。
5、交付 PDF。

例如,要产出一份按模块分章的考研数学练习集,你只需要给出各章标题和题目,封面、章节顺序、公式渲染都交给 Skill 处理。

适用场景与注意事项

适合谁:

  • 需要批量产出数学练习题、试卷、作业集 PDF 的人,尤其是考研数学方向。
  • 不想手写 LaTeX 排版、希望内容与版式分离的使用者。
  • 希望生成后有自检步骤、降低公式语法返工的人。

限制与坑:

  • 公式必须按 LaTeX / KaTeX 语法书写。语法写错时,防错规则只能拦住明显错误,复杂公式仍需自己核对。
  • HTML + KaTeX 路线依赖 Playwright 环境可用;LaTeX 路线依赖 xelatex 可用。环境缺依赖时输出会失败,这是两条路线各自的前置条件。
  • 本 Skill 版本为 1.0.0,来源为 community,功能以官方简介为准,未提供的部分不要自行假设。
  • 抓取资料中给出的评分与下载量来自 SkillHub 页面快照(评分 100000、下载 2466),仅作页面状态参考,不代表长期表现。

小结

这个 Skill 的价值在于把「出题 + 排版 + 出 PDF」压缩成一次调用:公式按 LaTeX / KaTeX 排版,封面和章节结构一并生成,并提供防错规则与自检脚本。两条输出路线覆盖了有无 LaTeX 环境两种情况,按环境选择即可。

官方地址:https://api.skillhub.cn/user_ce094de0/math-exercise-pdf

SkillHub 页面:https://www.skillhub.cn/skills/user_ce094de0/math-exercise-pdf

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜