写技术教程最尴尬的一点：文字讲得头头是道，读者一跑代码全是坑。我这些年攒了不少笔记，一直想找个既能写概念、又能嵌可运行实验、还能一键出网站/PDF/EPUB 的工具。Quarto + Notebook 这套组合基本满足了我的贪心。本文用一个"AI Agent Loop 入门教程"做实例，从二十行的最小循环骨架，一路加料到接真模型、上安全文件工具、加记忆和任务验收的可用 Agent，演示怎么把 .qmd 文字章节、.ipynb 可运行实验、Mermaid 时序图拼成一本能在线读、能导出出版的书。