手记写作模板 —— 这篇是结构示例，不是真文章

这篇是结构示例，占着列表页第一个位置。它是给你自己看的写作说明，

不是给别人看的文章 —— 写第一篇真手记时把它删掉就行。

怎么加一篇

1. 在 src/content/notes/ 下新建一个 .md 文件，文件名就是网址里的 slug

（比如 pipeline-180-days.md → /notes/pipeline-180-days）

1. 把下面这段 frontmatter 粘到文件最开头
2. 写正文，保存，npm run dev 里立刻能看到

---
title: 文章标题
date: 2026-09-24
category: 工作流拆解
summary: 一句话摘要，列表页和大卡都用它
cover: /covers/xxx.jpg
readMinutes: 12
tags: 标签一, 标签二
---

字段说明

• category 只能填四选一：工作流拆解 / 产品设计 / 工具实测 / 踩坑记录
• summary 会出现在列表页，写「这篇讲什么、结论是什么」，别写「本文介绍了……」
• cover 可选。不写就不渲染图片区，页面不会留一个空框
• readMinutes 可选。不写的话按正文长度估（中文 350 字/分钟）
• draft 可选。标了 true 的文章会在页面上挂一个「待替换」的提示条

正文支持的语法

只有这几种。没列在里面的写法会原样显示成文本，不会悄悄丢掉 —— 所以一眼能看出哪里写错了。

段落与小标题

## 是二级标题，### 是三级标题。二级标题会自动进左栏目录，三级不进。

强调

用 **两个星号** 包住就是加粗，用反引号包住就是 行内代码。

列表

无序列表：

• 第一项
• 第二项

有序列表：

1. 先做什么
2. 再做什么

引用

引用块会渲染成左侧带红线的一段 —— 手记里用它来写「为什么留它」这类需要单独强调的判断。

判断只有落到纸上才会被检一遍，所以写下来本身就是方法。

代码块

三个反引号开头、三个反引号结尾，中间是代码。可以标语言名，也可以不标。

def estimate_minutes(text: str) -> int:
    """按中文 350 字/分钟估算阅读时长"""
    return max(1, round(len(text.replace(" ", "")) / 350))

链接与分隔线

行内链接写成 [文字](https://example.com)，效果是 Anthropic 官方文档。

发布前自查这三条

1. 有没有雇主名、项目内部代号、同事姓名需要去掉
2. 说的东西是不是跑了两个月以上、还在用的
3. 有没有具体的数字，而不是「感觉快了不少」