如果你用 Markdown 编写技术文档，你早已体会到这种张力：文档的一部分是手写 prose，而另一部分——如目录、嵌入的代码片段、渲染后的图表——则源自其他地方。你如何处理这一边界，很大程度上反映了你的工作流程。 大多数文档工具链都以预处理程序（如 PET 或 Jamal）的方式解决这一问题：将源与输出分离。你维护一个模板文件，执行构建步骤，最终得到渲染后的文档。这种方式清晰、可预测且易于推理——但它引入了构建步骤，且输出文件并非你实际编辑或分享的对象。