# PDF Create

> 从零创建PDF文件工具。使用reportlab库生成专业PDF文档，支持自定义页面大小、标题、作者、 以及通过JSON配置内容结构（标题、段落、表格等）。当用户需要生成PDF报告、文档时使用此skill。

- Skill: `cas-bigdatalab/pdf-create` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add cas-bigdatalab/pdf-create`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cas-bigdatalab/pdf-create/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: Proprietary. LICENSE.txt has complete terms
- Author: cas-bigdatalab (https://skillmd.com/u/cas-bigdatalab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cas-bigdatalab/pdf-create

---


# pdf_create 技能

## 功能说明

该技能使用 reportlab 库从零创建专业的 PDF 文档，支持自定义页面大小、标题、作者信息，以及通过 JSON 配置灵活定义文档内容结构，包括标题、段落、表格等元素。

## 核心功能

- 支持自定义页面大小（letter/a4）
- 支持设置文档标题和作者信息
- 通过 JSON 配置灵活定义文档内容结构
- 支持多种内容元素：标题、段落、表格、分页符等

## 内容结构配置

content 参数支持以下类型的元素：

| 类型 | 说明 | 必填字段 | 可选字段 |
| :--- | :--- | :--- | :--- |
| title | 文档主标题 | text | - |
| heading1 | 一级标题 | text | - |
| heading2 | 二级标题 | text | - |
| paragraph | 段落文本 | text | - |
| spacer | 空白间隔 | - | height |
| page_break | 分页符 | - | - |
| table | 表格 | data | style |

## 使用方法

```bash
python scripts/run_pdf_create.py --output_path <输出路径> [选项]
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| :--- | :--- | :--- | :--- | :--- |
| output_path | string | 是 | - | 输出PDF文件路径 |
| title | string | 否 | - | 文档标题 |
| pagesize | string | 否 | letter | 页面大小（letter/a4） |
| author | string | 否 | - | 作者名称 |
| content | string | 否 | - | 内容JSON字符串或JSON文件路径 |

## 示例

### 示例1：创建简单PDF

```bash
python scripts/run_pdf_create.py --output_path ./output.pdf --title "我的报告" --author "张三"
```

### 示例2：通过JSON配置内容

```bash
python scripts/run_pdf_create.py --output_path ./report.pdf --content '[
    {"type": "title", "text": "年度报告"},
    {"type": "paragraph", "text": "这是一份使用pdf_create技能生成的专业报告。"},
    {"type": "heading1", "text": "一、项目概述"},
    {"type": "paragraph", "text": "本项目旨在展示PDF创建功能的强大能力。"},
    {"type": "table", "data": [["姓名", "部门", "职位"], ["张三", "技术部", "工程师"], ["李四", "市场部", "经理"]]}
]'
```

### 示例3：从文件读取内容配置

```bash
python scripts/run_pdf_create.py --output_path ./report.pdf --content ./content.json
```

## 注意事项

- content 参数可以是 JSON 字符串，也可以是 JSON 文件路径
- 表格样式支持自定义颜色、边框等属性
- 输出目录不存在时会自动创建