VMPrint

在前端开发和后端生成PDF的场景中，很多人曾被React-PDF、Puppeteer或Headless Chrome折磨：浏览器依赖重、布局不一致、服务器资源消耗大、难以在边缘环境运行。VMPrint带来了一个轻量而强大的替代方案。它是一个**纯JavaScript的确定性空间模拟排版引擎**，无需PDF.js、无需React、无需服务器、无需任何依赖，仅约1.7MB，即可实现多页文档的画布预览与PDF/SVG导出，从浏览器到Cloudflare Workers、AWS Lambda、Node.js、Deno等环境，输出完全一致。

VMPrint 网站截图

VMPrint的核心创新在于将文档排版视为一场“演员模拟”（Actor-Based Simulation）。传统HTML/CSS或PDF生成方案往往是黑盒渲染，而VMPrint把每个文档元素（如文本块、表格、图片）转化为自主“演员”（actors）。这些演员会根据约束（如分页、页眉页脚、表格跨页、首字下沉）相互协商几何位置，最终稳定成一个扁平的绝对定位盒子列表。你能精确获得每个元素的坐标、变换和状态，从而直接在Canvas上绘制预览，或导出到PDF/SVG，且预览和导出使用完全相同的布局结果，不存在“二次排版”导致的不一致问题。

VMPrint的主要特色

1. 极致轻量与跨环境一致性 浏览器打包后带标准字体仅约85KiB（Brotli压缩），完整引擎解压约1.7MB。性能出色：在Surface Pro 11上，325页、8万字文档布局仅需约410ms，渲染PDF仅29ms，总耗时2.32秒。无论在客户端还是服务器less环境，同一输入总是产生相同输出，完美适配边缘计算场景。
2. 强大多语言与复杂脚本支持 完整Unicode双向文本（BiDi）处理、阿拉伯语整形、CJK混合排版、语言感知断词等。无需引入笨重的HarfBuzz引擎，就能实现专业级出版排版，支持混合书写系统共享基线。
3. 动态脚本化与实时交互 元素支持onReady钩子，能在布局稳定后动态修改自身、发送消息或替换内容。特别适合生成带真实页码的页眉（如“第1页 共N页”）、目录（TOC）、复杂表格等——这些通常需要知道最终页数才能正确处理，而VMPrint在一次布局后就能得到准确信息。
4. 高可调试性与模块化设计 输出扁平几何数据，支持Actor追踪、叠加调试层、振荡检测等，让布局过程透明可见。核心引擎模块化拆分为多个独立npm包，便于按需使用。
5. 丰富渲染通道 Canvas实时预览 + PDF导出 + SVG单页导出。所有README中的示例图片都是用VMPrint自身渲染的，充分证明其出版级质量。

与React-PDF相比，VMPrint避免了React生态的重量和DOM依赖；与Puppeteer相比，它彻底摆脱了Chromium的170MB+开销和不稳定性。特别适合需要生成报表、发票、电子书、合同、研究论文等场景的开发者，尤其是在无头环境或资源受限的边缘部署中。

如何快速上手？

 安装非常简单：

git clone https://github.com/cosmiciron/vmprint.git
cd vmprint
npm install

使用示例：

import { createVMPrintPreview } from '@vmprint/preview';

const preview = await createVMPrintPreview(yourDocumentAST);
await preview.renderPageToCanvas(0, canvasElement);  // 实时预览
const pdfBytes = await preview.exportPdf();          // 导出PDF
const svg = await preview.exportSvgPage(0);          // 导出SVG

你可以用JSON AST定义文档，也可结合Markdown转AST工具快速生成内容。