导出为 PDF

通过 quarkdown c 运行 Quarkdown 的编译器 时，指定 --pdf 标志即可生成一个 PDF 文件。

• PDF 的内容与 HTML 输出在 Chrome 浏览器中渲染的结果完全一致。
• HTML 目标所支持的所有文档类型与功能在此同样受支持。

依赖要求

要从 HTML 生成 PDF，需要以下依赖：

• Node.js
• npm（通常随 Node.js 一起提供）
• Puppeteer（npm install puppeteer --prefix <quarkdown_dir>/lib）

包管理器与安装脚本已经会自动处理这些依赖。

额外选项

• --node-path <path>：设置 Node.js 可执行文件的路径。默认为 node。

• --npm-path <path>：设置 npm 可执行文件的路径。默认为 npm。

• --pdf-no-sandbox：在 PDF 生成期间禁用 Chrome 沙箱。这存在潜在的安全风险，应仅在确实必要时使用。例如，某些 Linux 发行版不支持无头沙箱。

环境变量

• QD_NPM_PREFIX：应查找 node_modules 的目录。如果 Quarkdown 是通过包管理器或安装脚本安装的，则默认为 lib。

手动导出（旧方式）

你可以通过浏览器内置的打印功能（CTRL/CMD + P）将 HTML 产物导出为 PDF。

虽然 paged（以及 plain）文档已经可以直接打印，但要保存 slides 文档为 PDF 还需要一些额外步骤。请参阅 Reveal 的说明文档 了解具体做法。