排出一本书

稿子写到一定篇幅，想看它印成书的样子，或要交一份排好的 PDF 给编辑：在写匠里，书一边写一边就排好了。

按 ⌘3（Windows 上是 Ctrl+3）切到卡片拼接：封面、目录、页码、书眉、脚注、插图一页页排好，就是这本书印出来的样子。回到卡片编辑改一个字，书页随之重排。三百页上下的书，导出 PDF 约一秒。

想先看一本排好的书，打开示范项目「写匠图书示范」：本页说的每一样，那本书里都有一张卡讲，章末还有「动手试一试」。

四步排出一本书

1. 建一张目录卡。目录卡是一张只有列表的卡片：每一行链到一张卡片，列表的先后就是书的先后；一行不带链接的文字是一章，下面缩进的几行是这一章的卡片。在列表里输入「【【」，选中一张卡片，便插入一条链接。
2. 选目录、封面与版式：项目设置 › 成品。
   • 目录：选「按目录卡编 ›」，指定刚建的目录卡（选「不要」就按大纲树的顺序排）。
   • 封面：「自动（用标题排一页）」就够了；想自己排，就建一张封面卡，放进目录卡的第一行。
   • 版式：选一张版式卡；不选就用默认版式。
3. 看成书：按 ⌘3，从头翻一遍。
4. 导出：在大纲里选中目录卡，按 ⌘E，选 PDF。得到的是一本排好的书，可以打印，也可以交给编辑。

插图、脚注、公式、参考文献怎么写

在 md 卡里这样写，卡片拼接与导出都认：

• 插图：把图片粘贴或拖进卡片，就插入了一张图，方括号里的文字是图注。
• 脚注：在句末写 [^1]，另起一行写 [^1]: 和注文。编号由排版自动排。
• 公式：写在美元符号之间。行内写 $N$，单独成行写 $$P \approx \frac{N}{n} + k$$。
• 参考文献：项目里放一份 .bib 文献库，正文里写 [@key] 引用。导出时正文标上编号，书末排好参考文献，按 GB/T 7714—2025 的体例。
• 图示：流程图、时序图写在 mermaid 代码块里，预览与导出都画成图。更复杂的图表与版式，写在 typ 卡里。

书的样子：版式卡

书长什么样，写在版式卡里：开本、字体、行距、书眉、章首页。版式卡是一张 typ 卡，改一行，整本书跟着变。「写匠图书示范」里的「书的版式」可以照着改。

换一张版式卡：项目设置 › 成品 › 版式。

书长了再分卷

给每一卷建一张目录卡，列出本卷各章；再在全书目录里添一行，链到这张卷目录卡；版式卡里的「分卷」改成 true。

要按卷导出，在大纲里选中那一卷的目录卡，按 ⌘E。给某一卷单配封面：按 ⌘K 搜「这一卷的封面…」。

用了之后

看得见成品，就知道还差什么、哪一章太薄；交稿时不必再找人排版。导出别的格式（Word、电子书、网页……），见 三种格式与导出。