# @formepdf/html 中文文档

规范地址：https://npmcn.com/package/%40formepdf/html/

版本：0\.31\.0
npm 元数据更新时间：2026-11-05T16:58:15.704Z
中文译文更新时间：2026-11-15T08:36:54.156Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40formepdf/html
原文对照：https://npmcn.com/package/%40formepdf/html/?lang=original
项目主页：https://formepdf.com/
源码仓库：https://github.com/formepdf/forme

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：25.5 MB，30 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-08-29T00:53:15.399Z
- 最新版本发布：2026-11-05T16:58:15.477Z
- 近 30 天下载量：34294（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

HTML + 打印- CSS 到福尔米引擎上的PDF – pagination,运行头,页面计数器. 没有无头浏览器 .

## 安装

```sh
npm install @formepdf/html
```

也可以使用：`pnpm add @formepdf/html`、`yarn add @formepdf/html`、`bun add @formepdf/html`

## README

# 页面存档备份,存于互联网档案馆@formepdf/html

HTML + 打印- CSS 到 PDF [福尔米](https://formepdf.com/) 发动机. 没有无头浏览器, 没有 Chromium 冷启动 — 一个 Rust 排版引擎 编译为 WASM, 在节点运行的地方运行 .

```
npx @formepdf/html invoice.html
```

```js
const { renderHtml } = require('@formepdf/html');

const { pdf, warnings } = renderHtml(html, { pageSize: 'Letter' });
fs.writeFileSync('invoice.pdf', pdf);
warnings.forEach((w) => console.warn(w)); // everything outside the subset, named
```

## 何谓有效

网页媒体CSS浏览器花了20年时间来运送——和部件 他们还没有:

-   **`@page`**: 大小(名称或尺寸)、边距、, `:first` 变体
-   **边框** (单位:千美元)`@top-center`, (中文(简体) ), `@bottom-right`,...):运行 页边距中的页眉/页脚 `content()` 字符串和 `counter(page)` 编号 : `counter(pages)`
-   **断开控制**数字 : `break-before/after/inside` 加上遗产 `page-break-*` 拼写每个 wkhtmltopdf - 时代模板仍然带有
-   **`orphans` 编号 : `widows`**, (中文(简体) ), `<thead>` 每页重复
-   带有文档选择器子集的样式表,完整的级联 `!important`,有弹性框,一个 CSS Grid 子集,有相册/相册的表格, 列表、 图像
-   **浮动为列行** —— 说 `float: left/right` + 键 `clear` 卧倒 连续漂出一排的兄弟姐妹(靴子) `col-*` 财务报告和审定财务报表 使用真实模板的左/右头-平面形状; 只使用真实 文本与浮标一起被打开,它警告

根据来自GitHub (Bootstrap) 的15个真实生产模板测量 2/3个网格,mPDF/wkhtmltopdf-era 表格,电子邮件HTML,现代CSS网格: **15个案件中的14个正确地判定,一个已退化的案件可以辨明,因为 名称在 `warnings`, 0 渲染断开** (截至0.20.0) (中文(简体) ).

按财产分类的完整子表生活在 [仓库读取器](https://github.com/formepdf/forme/tree/main/html) —— 说 外面的一切都会降落在 `warnings`从来没有默默地放弃.

## 国 际

```
forme-html <input.html> [-o out.pdf] [--css print.css]
           [--page-size Letter] [--margin 36] [-q]
```

CLI/API 选项覆盖文档的 `@page` 规则, 打印方式 对话框覆盖样式表.

## 常见问题

### @formepdf/html 是什么？

HTML \+ 打印- CSS 到福尔米引擎上的PDF – pagination,运行头,页面计数器\. 没有无头浏览器 \.

### 如何安装 @formepdf/html？

在项目目录运行 npm install @formepdf/html，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 forme-html，可以用 npx forme-html 直接运行。

### @formepdf/html 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @formepdf/html 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @formepdf/html 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @formepdf/html 可以商用吗？

@formepdf/html 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @formepdf/html 的下载量有多少？

根据 npm 官方下载统计，@formepdf/html 在 2026/10/16 – 2026/11/14 这 30 天内被下载 34,294 次，日均约 1,143 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @formepdf/html 还在维护吗？

最新版本 0\.31\.0 发布于 2026/11/06（10 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 19 个；首次发布于 2026/08/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。