制作

文档 社区 v1.0.0

技能解读

设计思路

make-pdf 是 gstack 把 markdown 转 PDF 的一条龙——背后用 browse daemon 渲染 + Paged.js 分页,可加 cover / TOC / 页码 / 水印 / accessible tagged PDF / heading bookmarks。设计哲学是用浏览器渲染管线而不是 LaTeX / Pandoc,因为 markdown 里嵌入的 HTML / CSS / 高亮代码块都已经是浏览器原生能力。

用户能看到的输出契约

stdout: /tmp/letter.pdf          ← 只有路径,一行
stderr: Rendering HTML...         ← 进度(除非 --quiet)
        Generating PDF...
        Done in 1.5s. 43 words · 22KB · /tmp/letter.pdf

exit code: 0 success / 1 bad args / 2 render error
           / 3 Paged.js timeout / 4 browse unavailable

习惯写法:PDF=$($P generate letter.md) 然后用 $PDF。

常用 flag

  • 页面尺寸 / 边距:--page-size letter|a4|legal、--margins 0.75in
  • 结构:--cover 封面(标题 / 作者 / 日期 / 细线)、--toc 可点击目录、--no-chapter-breaks 不在每个 H1 翻页
  • 品牌:--watermark "DRAFT" / "CONFIDENTIAL"、--header-template <html>、--footer-template <html>(与 --page-numbers 互斥)、--no-confidential 关右下水印
  • 输出选项:--page-numbers(默认开)、--tagged(accessibility,默认开)、--outline(heading bookmarks,默认开)、--quiet / --verbose
  • 网络:--allow-network(默认关——挡 tracking pixel);外链图片用到时再开
  • 元信息:--title "..."(默认拿首个 H1)、--author "..."、--date "..."

Claude 何时该跑

扫到这些 markdown→PDF 意图就跑 $P generate:

  • "Can you make this markdown a PDF"
  • "Export it as a PDF"
  • "Turn this letter into a PDF"
  • "I need a PDF of the essay"
  • "Print this as a PDF for me"

用户打开了 .md 还说「make it look nice」→ 提议 $P generate --cover --toc 先问后跑。

调试

  • 输出空白 → 检查 $B status(browse daemon 未跑)
  • 复制粘贴文字碎裂 → highlight.js 输出问题;暂时去掉 fenced code block 重生成
  • Paged.js timeout → 通常是 markdown 没有 heading;去掉 --toc
  • 外链图片缺失 → 加 --allow-network(理解你给文件赋予了对外抓 URL 的权限)
  • PDF 太长 / 太宽 → --page-size a4 或 --margins 0.75in

适合谁

  • 输出报告 / letter / essay / 招股书的人
  • 给客户看的 markdown 想加封面 + TOC + 水印的工程师
  • 写技术文档要 accessible PDF 的项目

不适合

  • 大量数学公式 / 学术排版 → LaTeX 路线效果更好
  • 需要 Word / PowerPoint 的可编辑产物 → docx / pptx

配套

browse(背后渲染引擎)、docx / pptx / xlsx(其它 Office 输出)、brand-guidelines(套品牌色)、canvas-design(视觉先行的海报路线)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
92 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@garrytan · v1.0.0 · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows · Docker
运行环境要求
Bun · Docker
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 make-pdf.preview
stdout: /tmp/letter.pdf          ← just the path, one line
stderr: Rendering HTML...        ← progress spinner (unless --quiet)
        Generating PDF...
        Done in 1.5s. 43 words · 22KB · /tmp/letter.pdf

exit code: 0 success / 1 bad args / 2 render error / 3 Paged.js timeout
           / 4 browse unavailable

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。