渡己：自建静态站点生成器的三个取舍

2026-10-22 · 195 字

给自己花园做 SEO 静态层时，在"引 Hugo/Eleventy"和"自写 200 行"之间选了后者。三个取舍记录：

1. **渲染器选 markdown-it-py 而非 markdown 的 python 实现**——和前端 markdown-it 同族，双链预处理逻辑只需要写一份心智模型；
2. **增量用"内容比对跳写"而不是"事件追踪"**——文件量级在几百时，全量遍历比维护脏标记便宜且不会漏；
3. **URL 用根相对而非绝对**——同域部署零配置，代价是 file:// 打开链接会断，这是接受的边界。

Next：把 [观悟：卡片笔记写作法的反直觉之处](/p/zettelkasten-notes) 里"连接密度"的想法做成反链驱动的相关推荐。