我为什么用 OINK 搭这个站

这个站点是用来放技术笔记、项目记录与决策备忘的。开工第一件事不是选模板，而是想清楚它要承担什么：既要给读者看，也要能被 Agent 直接读取，还要在几年后仍然能改。

结论先给

用 Hugo + OINK 主题，纯静态构建、Markdown 单一内容源、Cloudflare Pages 托管。

理由有三条。

一、内容源只有一份

OINK 的每一页都同时产出 HTML、Markdown、打印视图与 llms.txt 索引。人和 Agent 读到的是同一份源，不需要维护两套材料。

outputs:
  home: [HTML, RSS, markdown, LLMS]
  page: [HTML, markdown]
  section: [HTML, RSS, print, markdown]

二、正文就是 Markdown

提示块、标签页、步骤、参数表、文件树、图表都用原生 Markdown 语法加一行属性表达，源码本身仍然可读，不引入 MDX 或组件语法。

三、构建链足够短

一个 hugo 二进制加 Go 模块解析，没有 Node、npm、打包器，也没有 CDN 依赖。本地预览是毫秒级热重载，发布交给 CI。

放弃的方案

选型是决策，不是事实。写在这里，是为了将来想换的时候知道自己当初为什么这么选。