技能介绍

要解决什么问题

考研或日常刷题时，题目往往散落在笔记、聊天或 Word 里，公式要么变成纯文本，要么复制到文档后排版崩掉。若走完整 LaTeX 发行版，环境搭建和编译成本对「只想出一本可打印练习册」的人来说偏高。

技能如何工作

本技能把流程固定成收集元信息 → 选输出通道 → 生成文档三步：先确认标题、副标题、年份/系列和按章节组织的题目，再选 HTML（推荐） 或 LaTeX。

HTML 路径：以 assets/math_template.html 为底，填入封面与章节题目，保存后用 scripts/html_to_pdf.py 经 Playwright（Chromium headless） 导出 PDF；页面侧用 KaTeX 渲染 $...$ / $$...$$，不依赖本机 TeX。
LaTeX 路径：基于 math_template.tex，用 xelatex 编译，适合对版式与公式精度要求更高的场景。

题目侧需遵守 KaTeX 友好规则：所有 \frac、\sum 等命令必须在数学定界符内；不等号优先 \lt / \gt；填空线用 $\underline{\qquad\qquad}$ 。导出前脚本会做语法检查，并处理数学区内的 < / > 转义。

适用边界与注意点

HTML 导出依赖 KaTeX CDN 与 Chromium；断网或 CDN 不可达时，PDF 里可能出现未渲染的裸 LaTeX。自定义 CSS 若覆盖 .katex .mfrac 或给 .katex 过大 font-size，会出现分式错位或三角符号伪影。不确定环境时可用 scripts/self_check.py 做依赖与最小 PDF 冒烟检查；KaTeX 在 throwOnError: false 下失败公式可能静默保留原文，需在浏览器 Console 查看 ParseError。