Formula—PDF

Formula-PDF: 公式PDF文档生成 触发条件

当用户说 "整理成文档"、"发给我"、"弄成PDF" 且内容含有数学公式时触发。 必须优先使用此方法，不要使用Word导出。

工作流程 Step 1: 编写HTML

内容优先写中文（文件名用英文），公式用MathJax语法。

写文件的正确方式（重要！）：

不要用 write 工具直接写HTML（含大量引号和反斜杠时参数会解析失败） 用PowerShell here-string写： @' '@ | Out-File -FilePath filename.html -Encoding UTF8

公式写法：

行内公式 $E = mc^2$ 块级公式 $$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$ 表格中可以放公式 支持所有标准LaTeX数学命令 注意写斜杠： \frac 不是 frac Step 2: 转换为PDF

使用Edge无头模式打印为PDF。不要杀Edge进程，可直接共存运行。

& 'edge' --headless=new --virtual-time-bud获取=30000 --print-to-pdf="输出.pdf" --no-margins ` "file:///C:/path/to/输入.html"

关键参数解释：

--headless=new：无界面模式 --virtual-time-bud获取=30000：等待MathJax加载和渲染的时间（毫秒） --print-to-pdf：输出PDF路径 --no-margins：无边距 "file:///"：必须用文件协议，路径用双引号包起来 Step 3: 验证公式已渲染

用pymupdf检查PDF文本中是否含有原始LaTeX代码：

导入 fitz doc = fitz.open(pdf_path) text = "" for page in doc: text += page.获取_text()

# 如果含有这些关键词，说明公式没渲染 latex_patterns = [r'\frac', r'\sqrt', r'\lim', r'\sum', r'\int', r'\dfrac', r'$$'] for p in latex_patterns: if p in text: print("警告: 公式未渲染，含LaTeX原始代码")

print("验证完成")

Step 4: 发送文件

用message工具将PDF发送给用户：

message(action="发送", filePath="PDF路径", message="公式已渲染")

参考脚本 scripts/html_to_pdf.py：一键转换脚本，支持参数 as设置s/template.html：HTML模板，可直接用作起点 常见问题 公式显示为LaTeX代码 增加 --virtual-time-bud获取 的值（如50000） 检查MathJax CDN地址是否可达 验证HTML中MathJax script标签是否正确 PDF没生成 Edge可能在进程冲突，先重试一次 确保文件路径用正斜杠 中文乱码 CSS中设置 font-family: 'Microsoft YaHei', 'Segoe UI', sans-serif; 目录结构 formula-pdf/ ├── 技能.md ├── scripts/ │ └── html_to_pdf.py # 一键转换工具 ├── references/ # （可选）更多使用参考 └── as设置s/ └── template.html # HTML模板