学术级 PDF 排版，HTML 驱动

HTML-first PDF生成技能，专为报告、论文等长文档设计，确保Linux环境下稳定的分页布局、可搜索文本与专业学术风格输出。

基本信息

• 技能名称?Minimax Pdf
• 中文名称?学术级 PDF 排版，HTML 驱动
• 作者?krisliu16
• 分类?专业技能
• 版本?1.0.0
• 标签?pdf-generation, html-to-pdf, academic-writing, typesetting, latex-alternative, paged-media, print-ready, citation-management, katex, automation

使用方法

使用说明
minimax-pdf 技能评估
核心用途
minimax-pdf 是一套面向学术与专业场景的 HTML-to-PDF 转换技能，核心定位是替代传统 LaTeX/Word 排版工作流，通过标准化 HTML 模板生成印刷级 PDF 文档。其设计哲学强调"稳定性优先"——在 Linux 服务器运行时保证分页可控、文本可选、链接可点，而非追求浏览器端的视觉炫技。
显著优点

1. 工程化约束体系
   技能文档以"Hard Constraints"形式明确禁止 screenshot/print hacks、Paged.js 手动注入、动态图表库等不稳定路径，大幅降低跨环境翻车概率。对 CSS counters、emoji 装饰、深色主题等易踩坑点均有黑名单管控。
2. 学术场景深度优化
   内置 IEEE 数字引用格式模板与参考文献校验规则
   显式编号策略（markup-level labels）替代 CSS counters，避免分页重排导致的编号漂移
   KaTeX 数学公式与 Mermaid 图表的标准化集成方案
   目录页码自动解析（ target-counter ）与交叉引用完整性检查
3. Linux 运行时适配
   针对服务器无 GUI 环境优化，明确使用 html_to_pdf 单一入口，禁用本地浏览器打印等依赖图形栈的操作，确保容器化部署稳定性。
4. 意图分类与澄清策略
   将用户请求细分为 Build/Transform/Existing-ops/LaTeX-explicit 四类管道，并执行"最多一轮澄清"原则，平衡灵活性与执行效率。
   潜在局限
   视觉风格单一 明确排斥 dashboard 美学（卡片、KPI 墙、深色装饰条），仅提供 print-academic 视觉方向，对商业提案、营销手册等场景适配性弱
   动态内容受限 强制预渲染图表为静态图片，ECharts/Plotly 等交互式图表无法保留探索功能
   版式调试门槛 虽然提供 F9 调参优先级表，但仍需理解 CSS Paged Media 与 Paged.js 的底层机制，非前端开发者上手成本较高
   中文排版细节未覆盖 文档未提及 CJK 行尾标点挤压、禁则处理、竖排等需求，中文科技论文可能需要额外补丁
   适合人群
   技术写作者、学术研究者、需要版本可控的自动化报告生成场景
   已有 HTML 内容需批量转 PDF 的 DevOps/数据工程团队
   对 LaTeX 编译链感到头痛，但不愿牺牲学术排版规范的用户
   常规风险
   动态图表预渲染环节若处理不当，易出现分辨率不足或字体嵌入失败
   跨字体 fallback（尤其 emoji 与 CJK）在 Linux 环境可能产生非预期字形替换
   复杂表格横向溢出时，自动缩放策略可能破坏可读性