生成 PDF

用户1208

5月29日修改

使用具有现代排版和设计的 Claude Code，生成专业 PDF（文档、白皮书、报告）。​

1.
TL;DR​

2.
适用场景​

3.
技术栈概览​

4.
配置​

5.
工作流​

6.
与 Claude Code 集成​

7.
自定义​

8.
故障排查​

9.
延伸阅读​

TL;DR

代码块

# 安装​
brew install quarto  # macOS​
​
# 生成​
quarto render document.qmd  # → document.pdf​
​
# 预览​
quarto preview document.qmd  # 热重载​
​

技术栈：Quarto（编排）+ Typst（排版）+ Pandoc（Markdown）

适用场景

使用场景

适合度

替代方案

技术文档

✅

—

白皮书 / 报告

✅

—

API 文档

⚠️

OpenAPI + Redoc

幻灯片 / 演示文稿

⚠️

Quarto Revealjs

快速笔记

❌

纯 Markdown

协作编辑

❌

Google Docs、Notion

最适合：需要专业排版、版本控制和可复现性的长篇技术内容。​

技术栈概览

代码块

┌─────────────────────────────────────────────────┐​
│               你的 .qmd 文件                    │​
│       （Markdown + YAML 前置元数据）            │​
└─────────────────────────────────────────────────┘​
                        │​
                        ▼​
┌─────────────────────────────────────────────────┐​
│                   Quarto                        │​
│             （文档渲染引擎）                    │​
│         • 处理 YAML 元数据                      │​
│         • 管理扩展                              │​
│         • 管理输出格式                          │​
└─────────────────────────────────────────────────┘​
                        │​
          ┌─────────────┴─────────────┐​
          ▼                           ▼​
┌─────────────────────┐    ┌─────────────────────┐​
│       Pandoc        │    │       Typst         │​
│   （MD → AST → ?）  │    │  （排版/PDF）       │​
│  • Markdown 解析器  │    │  • 现代引擎         │​
│  • AST 转换         │    │  • 快速编译         │​
│  • 格式桥接         │    │  • 无需 LaTeX       │​
└─────────────────────┘    └─────────────────────┘​
                        │​
                        ▼​
┌─────────────────────────────────────────────────┐​
│                 document.pdf                    │​
│          （专业排版输出）                       │​
└─────────────────────────────────────────────────┘​
​

生成 PDF​

生成 PDF