记录那些正在形成的东西

Warning

这篇文章仍然承担一部分页面元素测试的作用。

但我也不想让它只剩下一堆散开的样本，所以还是把它写成一篇真正能成立的文章。

我原来总觉得，只有在一件事被彻底想清楚之后，才值得写成文章。

所以我以前会下意识把写作往后推。

要么等自己把问题想透，要么等经历足够完整，要么等觉得“这篇已经像一篇正式文章了”再动笔。

但这次折腾博客时，我突然意识到，这种想法本身就让我错过了很多值得记录的东西。

这次折腾博客时，我其实已经在记录了

这几天我一直在反复调这个博客。

我做的事情看起来很碎：

• 把内容结构从一堆僵硬分类，收成“文章 / 笔记 / 专题 / Now”
• 调整侧边目录里的入口顺序，让它更像真实写作，而不是后台菜单
• 修 GitHub Actions 里 pnpm 的执行顺序
• 修 Vercel 上顶层页面的 clean URL，让 /about 这种地址不再直接掉进 404
• 把域名、部署和静态托管这一套重新接顺

我本来把这些事都当成搭博客时的杂活。

后来才发现，不对。

这里面其实全是判断。

真正值得记下来的，不只是最后那个结论

比如这次最没有价值的，反而是“最后配好了”。

真正有价值的是这些：

• 我为什么不想把博客做成一套工整但难以下笔的分类系统
• 我为什么最后把主结构收成现在这几块
• 我在调试线上问题时，是怎么一步一步排除掉错误判断的
• 哪些配置是长期决定，哪些只是为了先跑通

这些东西如果不及时记下来，过几天就会被我自己美化成一个干净结论。

可真实过程不是那样的。

它往往更乱，也更有用。

有些内容，成熟之后再写就太晚了

我慢慢意识到，我真正想记录的，不只是“已经成熟的答案”。

我更想记录这些东西：

• 一个判断是怎么形成的
• 一个结构为什么会被改掉
• 一个问题最开始是怎么被误判的
• 我为什么会在某个时刻突然觉得“这里该留下来”

这些内容未必都适合放进笔记。

因为笔记更像以后回来检索和复用的东西。

它们也不一定都要长成专题。

因为很多事情只是当下的一次判断、一段过程、一个转折点。

这种时候，写成一篇文章反而最合适。

这篇文章对我来说，更像一个起点

这篇其实也顺手完成了另一件事：它就是我拿来继续调试博客的第一篇真文章。

拿它去验证文章页、列表页、部署、域名、链接、标签，反而比继续塞测试数据更靠谱。

但比“调试用途”更重要的是，我想用它给这个博客定一个起点。

以后这里不只会记录那些已经被我整理好的东西。

我也会记录那些正在形成、正在变化、正在逼着我做判断的东西。

如果哪天我回头看，发现这篇有点生涩，那也没关系。

至少它是从真的地方开始的。

---

附录：排版测试场

既然这篇算是起步，干脆直接让它兼职当排版的“跑马场”。 我不想再假装下面的元素跟正文有什么上下文连贯性了，下面全是直接怼上来的纯测试样例。我只需要确信 Quartz 把这些基础砖块渲染出来是好看的。

1. 代码块与高亮

Bash 终端命令：

pnpm check
pnpm test
pnpm quartz build

JSON 配置文件：

{
  "$schema": "https://openapi.vercel.sh/vercel.json",
  "cleanUrls": true
}

TypeScript 代码：

const order: Record<string, number> = {
  notes: 0,
  posts: 1,
  topics: 2,
  tags: 3,
  archive: 4,
}

2. 双链与页面嵌入

常规双链：index 带别名的双链：去看看笔记页 带锚点的双链：跳回测试区顶部

页面内容嵌入（Transclusion）：

关于

你好，我是 thornboo。

我做 Web 开发，也长期对写作、阅读、工具和个人系统这类东西有兴趣。

这个博客不想做成一套整齐但没什么气味的知识库。

我更想把它写成一个长期现场，或者说，一个真正的数字花园。

这里现在按几种最简单的内容来放东西：

• 有完整文章
• 有平时会反复补的笔记
• 有持续展开的专题，把文章和笔记串联起来
• 有一个持续更新的 Now 页面

我不太喜欢那种把一切都切成工整技术分类的结构。

因为真实的写作过程，通常不是按 前端 / 工程化 / AI / 工作流 这样长出来的。

它更像：

• 某个问题被认真想清楚了，于是写成一篇文章
• 某些东西我知道以后还会回来补，于是变成笔记
• 某条线值得长期追，于是长成专题
• 某些事情只属于现在，于是写进 Now

如果你第一次来，我更推荐你先看这些：

• 笔记
• 专题
• Now

想按主题找内容，就去 标签；按时间回看所有内容，就去 归档。

指向原始笔记的链接

3. 数学公式与 Mermaid 图表

行内公式测试：最著名的质能方程是 $E=m{c}^2$。

块级公式测试：

$$\sum _{i=1}^{n}i=\frac{n(n+1)}{2}$$

Mermaid 流程图测试：

flowchart LR
  A[起点] --> B[节点1]
  B --> C[节点2]
  C --> D[终点]

4. 行内样式与引用

这是一段包含 高亮文本、删除线文本 以及 粗体 和 斜体 的行内样式测试。 标签渲染测试：#写作/结构、#博客/调试。 箭头连字符渲染：A → B ⇒ C。

普通的块级引用：

别管什么完美的知识库，先把字敲出来。 —— 也就是别陷入无休止的工具折腾。

这是一句带脚注的测试文本，用来看看页面底部的脚注区域长什么样。¹

5. 列表、表格与标题层级

任务列表：

• 核心结构搭建
• CI/CD 部署通畅
• 产出第一篇实质内容

这是一个四级标题 (H4)

放在这里单纯是为了看右侧 TOC（目录）里的层级缩进是不是正常。

表格渲染测试：

模块	核心用途	状态
文章	写完整的、可独立存在的思考	🟢 启用
笔记	放需要反复检索和补充的碎片	🟢 启用
专题	梳理长期延展的脉络	🟢 启用

6. Callout 提示框

默认提示框：

Note

这是一个标准的 Note 类型 Callout，检查一下背景色和左侧图标。

折叠提示框：

点开看看隐藏内容

折叠交互顺畅。以后适合把大段的补充说明藏在这里，避免打断正文。

Footnotes

1. 这里是脚注的具体内容，通常用来塞一些不想放在正文里的碎碎念或扩展阅读链接。 ↩