# html2pdf
**Repository Path**: jakHall/html2pdf
## Basic Information
- **Project Name**: html2pdf
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-01-25
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# HTML2PDF - 专业的PDF报告生成器
一个强大的命令行工具，将HTML文件转换为专业的PDF文档，支持自动生成封面、目录和页码。
## 功能特性
- ✅ **自动封面生成** - 从HTML元数据提取标题、作者等信息生成专业封面
- ✅ **智能目录生成** - 自动提取章节标题并生成带页码的目录
- ✅ **多纸张尺寸** - 支持A4、A3、Letter、Legal等多种标准纸张尺寸
- ✅ **自定义页边距** - 灵活设置页边距，支持统一或分别设置
- ✅ **精确页码计算** - 基于实际渲染结果计算章节页码
- ✅ **横向/纵向** - 支持横向和纵向打印
- ✅ **元数据提取** - 自动从HTML中提取标题、作者等信息
- ✅ **命令行友好** - 简洁直观的命令行界面
## 安装
```bash
# 克隆项目
git clone
cd html2pdf
# 安装依赖
npm install
# 或使用 yarn
yarn install
```
## 快速开始
### 基本用法
```bash
# 将HTML文件转换为PDF（自动生成输出文件名）
node src/cli.js input.html
# 指定输出文件名
node src/cli.js input.html output.pdf
# 使用 npm script
npm start -- input.html output.pdf
```
### 完整选项
```bash
node src/cli.js input.html output.pdf \
--size A4 \
--title "我的报告" \
--author "张三" \
--date "2024-01-23" \
--margin "40,50,40,50" \
--landscape \
--debug
```
## 命令行选项
| 选项 | 说明 | 默认值 |
|------|------|--------|
| `` | 输入的HTML文件路径（必需） | - |
| `[output]` | 输出的PDF文件路径（可选） | 基于输入文件名生成 |
| `-s, --size ` | 纸张尺寸 (A4, A3, Letter, Legal等) | A4 |
| `--no-cover` | 不生成封面页 | 生成封面 |
| `--no-toc` | 不生成目录页 | 生成目录 |
| `-a, --author ` | 设置作者 | 从HTML提取或Unknown |
| `-t, --title ` | 设置标题 | 从HTML提取或文件名 |
| `-d, --date <date>` | 设置日期 | 从HTML提取或当前日期 |
| `-m, --margin <margin>` | 页边距（单位：像素） | 40 |
| `--landscape` | 横向打印 | 纵向 |
| `--debug` | 调试模式 | 关闭 |
### 页边距格式
- 单个值：`--margin 40` （所有边相同）
- 四个值：`--margin "40,50,40,50"` （上、右、下、左）
### 支持的纸张尺寸
**国际标准 (ISO 216)**
- A0, A1, A2, A3, A4, A5, A6, A7
- B0, B1, B2, B3, B4, B5
- C4, C5, C6
**北美标准**
- Letter, Legal, Tabloid, Ledger, Executive
**自定义尺寸**
- 使用格式：`WIDTHxHEIGHT`（毫米）
- 例如：`--size "210x297"`
## HTML 文件格式
为了让工具正确提取元数据和生成目录，建议按以下格式编写HTML：
```html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="title" content="我的报告标题">
<meta name="author" content="作者姓名">
<meta name="date" content="2024-01-23">
<title>我的报告标题
第一章：引言
这是第一章的内容...
1.1 背景
这是小节的内容...
第二章：正文
这是第二章的内容...