02 · 内容沉淀阶段
在装任何工具之前，先写够 3 篇有质量的内容。这一步看似最朴素，其实最重要。
一、为什么"内容优先"
❗ 80% 的人在这一步就放弃了：花一周搭博客框架、调主题颜色、对比 SSG 工具，结果一篇文章没写。
正确顺序：
写 3 篇 → 确认主题值得 → 装工具 → 部署错误顺序：
装工具 → 调主题 → 找 demo 内容 → 灵感枯竭 → 弃坑二、起步阶段的最简结构
~/notes/我的主题/
├── README.md # 主题导论 / 阅读指引
├── 01-第一篇.md
├── 02-第二篇.md
└── 03-第三篇.md就这样。不需要任何配置文件、不需要 git、不需要前端工具。只用文本编辑器 + markdown。
三、内容组织模式
模式 A：教程系列（推荐新人）
~/notes/某主题/
├── README.md # 总览 + 学习路径
├── 01-快速入门.md # 5 分钟看懂
├── 02-完整规则.md # 详细介绍
├── 03-进阶细节.md # 深入
├── 04-策略与误区.md # 实战建议
├── 05-学习资源.md # 推荐资源
└── 06-术语速查表.md # 工具页适合：把一个主题从入门到熟练讲完整。
模式 B：日记 / 复盘
~/notes/某主题/
├── README.md
├── 复盘-001.md
├── 复盘-002.md
└── 复盘-003.md适合：定期记录、迭代式更新。
模式 C：混合（推荐成熟主题）
~/notes/某主题/
├── README.md
├── guide/ # 教学系列
│ ├── 01-入门.md
│ └── ...
├── replays/ # 复盘 / 日记
│ ├── 001.md
│ └── ...
└── reference/ # 速查 / 工具
└── glossary.md适合：内容多到需要分类时（≥ 10 篇）。
💡 演化路径：从 A → 内容增多到 ≥ 10 篇 → 重构为 C。不要一上来就用 C——过度设计。
四、文件命名规范
基本规则
| 规则 | 推荐 | 不推荐 |
|---|---|---|
| 用中文还是英文？ | 中文（仓库友好） | 英文（分享时再 rewrite） |
| 加序号吗？ | 教程类必加（决定阅读顺序） | 单纯按时间排无所谓 |
| 用空格还是连字符？ | 不用空格 —— 用 - 或 · | 文件名带空格（git 路径会被引号包围） |
| 后缀 | 统一 .md | 混用 .markdown |
推荐示例
✅ 01-快速入门.md
✅ 02-完整规则.md
✅ 复盘-2026-06-08.md
✅ guide/quick-start.md # 在 C 模式分类下，可以英文
❌ Quick Start.md # 空格 + 英文
❌ 1.md # 没说明内容
❌ 我的入门笔记.md # 没序号、信息少序号策略
- 两位数（
01-而非1-）—— 文件多了排序对齐 - 预留间隔——比如
01、05、10，方便插入新内容时不打乱
五、单篇文章的内部结构
推荐骨架
markdown
# 标题（H1，全文唯一）
> 一句话引子（描述这篇文章解决什么问题）
---
## 一、第一节（H2，全文不超过 8 个）
### 子节（H3，详细内容）
正文...
---
## 二、第二节
...
---
## 总结 / 下一步
简短小结，引导到下一篇。几个细节
- 引子要短 —— 1–2 句，告诉读者"花时间读这篇有什么收益"
- 多用表格 + 列表 —— Markdown 渲染最适合的两种结构
- 代码块要带语言标识 ——
```bash、```typescript - 章节用分隔线 ——
---视觉上清爽 - 结尾导航 —— "下一步看 XXX"，帮读者继续阅读
- 一篇 ≤ 8000 字 —— 超过就拆分，长文阅读体验差
六、README 的特殊地位
README.md 在你的体系里要同时承担三个角色：
| 场景 | 它的角色 |
|---|---|
| 在 Gitee/GitHub 仓库 | 仓库主页（默认渲染） |
| 在编辑器里 | 主题总览索引 |
| 在博客里 | 通常被排除（首页用专门的 index.md） |
README 推荐结构
markdown
# 主题名
> 一句话定位（这个仓库是什么、给谁看的）
## 这是什么 / 为什么
简短背景介绍。
## 内容索引
| 顺序 | 文件 | 内容 | 适合谁 |
|---|---|---|---|
| 1️⃣ | [`01-入门.md`](./01-入门.md) | XXX | 新人 |
| ...
## 相关链接
- 博客地址（部署后回填）
- 联系方式七、内容完成后的检查清单
写完 3 篇后，问自己：
- [ ] 这些内容别人也想看吗？还是只有我自己感兴趣？
- [ ] 我未来 3 个月会继续写这个主题吗？还是一时兴起？
- [ ] 朋友点开第一篇，能在 5 分钟内看懂为什么这是好内容吗？
3 个都是 yes → 进入下一阶段（装 git）。 有 1 个 no → 别浪费时间装框架，继续写或换主题。
八、写作工具推荐
任意 markdown 编辑器都行，但有偏好：
| 工具 | 优势 | 适合 |
|---|---|---|
| Obsidian | 双链笔记 + 本地优先 | 长期笔记沉淀 |
| VS Code / Cursor | 强大的 markdown 预览 + 即将用来管 git | 推荐（一站式） |
| Typora | 所见即所得 | 不熟悉 markdown 语法的人 |
| Notion | 团队协作 | ❌ 不推荐——导出 markdown 格式有兼容问题 |
这次实践用的是 Cursor——既能写内容，又能直接对话调指令搭博客。
下一步
3 篇内容写好了 → 03-git-and-remote.md 开始把内容上版本管理。