如何用 gstack /make-pdf 与 /diagram 实战：Markdown 变出版级 PDF，英语变可编辑图表
【免费下载链接】gstackUse Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA项目地址: https://gitcode.com/GitHub_Trending/gs/gstack
🚀 gstack 是 Y Combinator CEO Garry Tan 开源的 Claude Code 工具集，其中/make-pdf能把任意 Markdown 文件一键变成出版级 PDF，/diagram能把一段英语描述变成可编辑的 Mermaid 图表三件套。这两个技能全程离线运行，是写文档、画架构图、导出报告的实用组合拳。本文面向新手，带你 10 分钟上手这两个神器。
为什么选 gstack 做 PDF 和图表
gstack 包含 23 个"专家角色"技能，/make-pdf和/diagram是其中文档生产力最强的两个：
| 技能 | 输入 | 输出 | 一句话评价 |
|---|---|---|---|
/make-pdf | 任意.md文件 | 出版级 PDF / 单文件 HTML / Word | 1 英寸页边距、智能分页、可点击目录、DRAFT 水印 |
/diagram | 一句英语描述 | .mmd源码 + 可编辑.excalidraw+ SVG/PNG | 永远交付"三件套"，绝不只给一张死图 |
两者的核心卖点：
- 📄出版级排版：正文左对齐、斜体引号与破折号、运行页眉、页码、目录书签，效果媲美 Faber & Faber 的实体书
- 🔌完全离线：Mermaid 和 Excalidraw 运行时打包在 lib/diagram-render/ 中，渲染不依赖任何 CDN
- 🔄图表永久可编辑：把
.mmd源码嵌进 Markdown，PDF 里渲染成矢量图，改一个字重新生成即可
30 秒安装 gstack
先 clone 仓库并运行 setup，两个技能即可使用：
git clone --single-branch --depth 1 https://gitcode.com/GitHub_Trending/gs/gstack ~/.claude/skills/gstack cd ~/.claude/skills/gstack && ./setup/make-pdf 实战：Markdown 一键变 PDF
最常用的场景：备忘录与信件
一条命令搞定，默认带运行页眉、页码和 CONFIDENTIAL 页脚：
$P generate letter.md # 输出到 /tmp/letter.pdf $P generate letter.md letter.pdf # 指定输出路径出版模式：封面 + 目录 + 章节分页
$P generate --cover --toc --author "你的名字" --title "文章标题" essay.md essay.pdf每个一级标题（H1）自动另起新页，正好适合长文。
草稿阶段：斜向 DRAFT 水印
$P generate --watermark DRAFT memo.md draft.pdf每页都有 10% 透明度的斜向水印，定稿后去掉参数重新生成即可。
快速预览：跳过 PDF 往返
$P preview essay.md用同一套打印 CSS 渲染成 HTML 并在浏览器打开，边改 Markdown 边刷新，满意了再生成 PDF。
其他实用技巧
--to html：导出单文件HTML，图表内联 SVG、图片转 data URI，零网络请求，直接发邮件--to docx：导出 Word，保留标题、表格、代码块等完整内容--strict：CI 模式，图片缺失直接报错，适合文档流水线- Linux 用户记得安装
fonts-liberation字体，保证 Helvetica 正确渲染
/diagram 实战：英语变可编辑图表
一次交付三件套
对 Claude 说"画一张部署流程的流程图"，/diagram会生成：
| 文件 | 用途 |
|---|---|
<slug>.mmd | Mermaid 源码，唯一事实来源，改它就能重新渲染 |
<slug>.excalidraw | 打开即可拖拽编辑的场景文件，带手绘风格 |
<slug>.svg+<slug>.png | 矢量图放文档，300dpi 位图发群聊/Issue |
在 git 仓库里产物默认落在./diagrams/，可以直接提交进版本库。
两条实用规则
- 流程图（graph LR / graph TD）最适合：它们能转换成完全可编辑的 Excalidraw 场景；时序图、状态图等也能渲染 SVG/PNG，只是没有可编辑场景
- 节点标签要短：细节写进连线标签，5–15 个节点是最佳可读区间
两个技能的黄金搭档
写文档要插图时，最佳实践是**把.mmd源码嵌进 Markdown 的 `mermaid page=landscape ← 强制该图表独占横版页
## 常见问题速查 | 现象 | 解法 | |---|---| | 图表报错 "diagram-render bundle not found" | 在 gstack 仓库运行 `bun run build:diagram-render` 或重跑 `./setup` | | 宽图内联时被压扁 | 给围栏加 `page=landscape` 独占一页 | | 出现 "[remote image blocked]" 占位符 | 远程图片默认被拦截（离线策略），需要时加 `--allow-network` | | PDF 空白 | 检查 browse 守护进程：`$B status` | ## 相关资源 - PDF 技能完整说明：[make-pdf/SKILL.md](https://link.gitcode.com/i/97c70bfff1f9a97b73c981deefdd3859) - 图表技能完整说明：[diagram/SKILL.md](https://link.gitcode.com/i/a724ac1a1f723a0455bd68e0aba5b34e) - 图表与多格式导出官方指南：[docs/howto-diagrams-and-formats.md](https://link.gitcode.com/i/3a59adf401ff3ecbdd9bd7f9950e21a1) - 离线渲染引擎源码：[lib/diagram-render/](https://link.gitcode.com/i/4030dc8eac54c8712ac0526621fb7a1c) - Markdown 图片尺寸指令解析：[make-pdf/src/image-policy.ts](https://link.gitcode.com/i/b0d01ec4ba1691da601f4ee9deb9e523) 💡 **上手建议**：先拿一份现成的 Markdown 备忘录跑一次 `generate`，再让 `/diagram` 画一张流程图嵌进去——10 分钟你就能体会到"Markdown 变出版级 PDF、英语变可编辑图表"的全部乐趣。【免费下载链接】gstackUse Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA项目地址: https://gitcode.com/GitHub_Trending/gs/gstack
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
