Report Title
Summary
Content...
从Markdown、HTML、数据或代码生成专业PDF。支持报告、发票、合同等符合最佳实践的文档。
User 需要创建、生成或导出 PDF 文档
功能概述
User 需要创建、生成或导出 PDF 文档是一项面向实际任务的技能，主要用于代理处理多个源( 马克当、 HTML、 JSON、 模板) 的文档生成、 格式化、 样式化和批量 p。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
适用场景
用户需要创建、生成或导出 PDF 文档。Agent 负责从多种来源（Markdown、HTML、JSON、模板）生成文档，并完成格式化、样式设置及批量处理任务。
适用范围
本技能仅限于：
- 提供 PDF 生成的代码范式与实现指导
- 讲解工具选型、面向打印的 CSS 编写方法以及文档结构设计原则
- 展示常见文档类型的参考示例
本技能绝不执行以下操作：
- 直接运行代码或生成文件
- 发起网络请求
- 访问用户工作目录以外的任何文件
所有代码示例仅为供用户自行实现所用的参考范式。
快速查阅
| 主题 | 文件 |
|---|---|
| 工具选型 | tools.md |
| 文档类型 | templates.md |
| 高级操作 | advanced.md |
核心规范
1. 选择合适的工具
| 输入源 | 推荐工具 | 原因 |
|---|---|---|
| Markdown | pandoc | 原生支持，自动生成目录（TOC），支持模板 |
| HTML/CSS | weasyprint | CSS 支持最完善，无需 LaTeX 环境 |
| 数据/JSON | reportlab | 编程式控制，精度高、灵活性强 |
| 纯文本 | fpdf2 | 轻量级、速度快 |
默认推荐： 对大多数基于 HTML 的文档，优先选用 weasyprint。
2. 先结构，后样式
# 正确：语义化结构 html = """""" # 错误：以样式为先 html = "
3. 显式控制分页
/* 在元素前强制分页 */
.new-page { page-break-before: always; }
/* 防止元素内部断页 */
.keep-together { page-break-inside: avoid; }
/* 标题后不孤行（避免标题单独出现在页尾） */
h2, h3 { page-break-after: avoid; }
4. 始终设置元数据
# weasyprint 示例模式 html = """Document Title ... """
5. 使用面向打印优化的 CSS
@media print {
body {
font-family: 'Georgia', serif;
font-size: 11pt;
line-height: 1.5;
}
@page {
size: A4;
margin: 2cm;
}
.no-print { display: none; }
}
6. 验证输出结果
生成任意 PDF 后，请执行以下检查：
- 检查文件大小（0 字节表示生成失败）
- 打开文件并确认页数是否正确
- 验证字体是否正常渲染
常见陷阱
| 陷阱 | 后果 | 修复方式 |
|---|---|---|
| 缺失字体 | 回退至系统默认字体 | 使用 Web 安全字体 |
| 图像路径为绝对路径 | 图像无法加载 | 改用相对路径 |
| 未指定页面尺寸 | 布局不可预测 | 显式设置 @page { size: A4; } |
| 图像尺寸过大 | 生成 PDF 文件体积异常庞大 | 使用前对图像进行压缩 |
安全与隐私
本技能为参考性质。 仅提供代码范式与实现指导，不执行任何实际操作。
所有数据均保留在本地：
- PDF 生成全过程在用户本地机器上完成
- 不会向外部发送任何数据
本技能不执行以下操作：
- 运行代码或生成文件
- 发起网络请求
- 访问系统文件
反馈
- 如本技能有用：
clawhub star pdf-generator - 保持更新：
clawhub sync
相关专题
Gradle插件开发入门教程
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
Gradle Wrapper配置教程
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
Golangci-lint检查器使用教程
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
Gradle怎么构建Java项目
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
PHP时间戳漏洞修复教程
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
Golangci-lint配置文件与规则设置
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
Golangci-lint安装与入门教程
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
2026.10.22
0
15
PHP2Shell高危漏洞修复教程
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
2026.10.22
0
12
热门下载
相关下载
精品课程
热门推荐
/
最新课程
phpStudy极速入门视频教程
共6课时 | 54.7万人学习
独孤九贱(4)_PHP视频教程
共89课时 | 134万人学习
PHP实战天龙八部之仿爱奇艺电影网站
共49课时 | 82.5万人学习
最新文章