# Apple Notes Style Guide

这份参考文档提供 Apple Notes 笔记美化时的细化规则。只要用户要求“严格按 Apple Notes 结构排版”“解释该用什么样式”“把草稿整理成长期可维护笔记”，就按这里执行。

## 核心原则

- `Title` 是整条笔记的文件名级信息，只出现一次
- `Heading` / `Subheading` 用来管理内容，不是装饰
- `Body` 承载解释、展开和补充判断
- 加粗只给必须扫到的内容
- 颜色不是强调器，颜色是分类器
- 列表、表格、引用、等宽文本和链接，只在对应关系成立时使用

## 1. 什么时候用 Title

`Title` 只用一次，只放整篇笔记最上面。

适用：

- 一篇文章一条笔记
- 一条长期知识卡片一条笔记
- 一个主题研究一条笔记

要求：

- 标题写成“主题 + 结论 / 对象”
- 不要写得过泛，比如“读书笔记”“文章总结”
- 最好让人以后在搜索栏里一眼知道这条笔记是干什么的

好例子：

- `为什么大多数总结没有价值：因为只有概述，没有判断`
- `AI Native Hiring Guide 总结：核心不是工具，而是工作方式重构`

不要在正文里重复用大标题冒充 `Title`。

## 2. 什么时候用 Heading

`Heading` 用来切一级模块。

适用场景：

- 一篇笔记内容超过 3 个模块
- 希望后续能快速折叠或展开某部分
- 这篇笔记会被长期维护，而不是看完就丢

推荐一级模块：

- `核心问题`
- `核心观点`
- `关键逻辑`
- `我的判断`
- `可行动点`

以下情况必须使用 `Heading`：

- 内容开始变长
- 一个模块下有多段解释
- 未来可能继续往该模块补内容

## 3. 什么时候用 Subheading

`Subheading` 用来切二级结构。

适用：

- 一个 `Heading` 下面有多个固定维度
- 想让信息结构稳定复用

特别适合总结型写法，例如把一个模块拆成：

- `现状`
- `问题`
- `根因`
- `解决方案`
- `启发`

或者拆成：

- `观点 1`
- `观点 2`
- `观点 3`

判断标准：

- 如果这一层内容未来会反复复用，就用 `Subheading`
- 如果只是临时一句补充，不要上 `Subheading`，直接写正文

## 4. 什么时候只用 Body

`Body` 承载所有普通解释、展开说明和补充信息。

适用内容：

- 概念解释
- 案例描述
- 逻辑展开
- 补充判断

规则：

- 一段正文只讲一个点
- 一段不要太长
- 如果连续出现 4 到 5 段没有层级的正文，说明应该补 `Heading` 或 `Subheading`

## 5. 什么时候加粗

加粗只给“读者必须扫到的东西”。

最适合加粗的只有 4 类：

1. 结论句
2. 关键词 / 方法论名词
3. 转折后的关键判断
4. 行动项里的关键动作

示例：

- `这篇文章真正要解决的不是效率问题，而是协作成本问题。`
- `主线` / `根因` / `行动建议`
- `表面上是在讲工具，本质上是在讲组织如何分工。`
- `先定义问题，再补证据，最后给判断。`

## 6. 什么时候不要加粗

不要这样用：

- 整段都加粗
- 一个自然段里加粗 4 次以上
- 只是因为“我觉得这句很重要”就加粗

判断标准：

- 一屏里最好只有 1 到 3 个加粗点
- 如果重点彼此打架，说明加粗过量

## 7. 什么时候用颜色高亮

颜色高亮只建议承担这 4 个功能：

- 黄色：核心结论 / 必记点
- 红色或粉色：风险 / 反例 / 误区
- 绿色：可执行动作 / 已验证有效的方法
- 蓝色：待验证问题 / 延伸阅读 / 关联线索

适用说明：

- 黄色适合“以后复习只看这些也够了”的句子
- 红色适合常见误解、容易踩坑的地方、需要警惕的判断
- 绿色适合下一步动作、建议保留的做法、可复用框架
- 蓝色适合“我还没想透”的问题、后续要补的资料、可链接到其他笔记的线索

## 8. 什么时候不要上颜色

不要给下面这些上颜色：

- 普通定义
- 普通解释
- 已经加粗过的普通句子
- 只是“看起来顺眼”的内容

颜色一多，信息价值就会迅速下降。

## 9. 什么时候用 Checklist

`Checklist` 适合：

- 待办动作
- 写作检查项
- 复盘核对项

例如：

- 是否说清核心问题
- 是否提炼出核心观点
- 是否保留关键逻辑
- 是否写出文章价值
- 是否给出我的判断

`Checklist` 只用于“要不要做 / 有没有做”，不要拿它写观点总结。

## 10. 什么时候用 Numbered List

适用：

- 有顺序的逻辑
- 操作步骤
- 因果链
- 论证流程

只要顺序不能乱，就用数字列表。

## 11. 什么时候用 Bullet List

适用：

- 平行观点
- 并列事实
- 多个例子
- 多条判断

如果顺序不重要，就不要强行上 `Numbered List`。

## 12. 什么时候用 Table

`Table` 适合：

- 对比两篇文章
- 做“现象 / 问题 / 根因 / 方案”模板
- 记录同一主题下多篇资料
- 统一采集信息

例如：

| 维度 | 内容 |
| --- | --- |
| 主题 | 这篇文章在讲什么 |
| 核心问题 | 作者要解决什么 |
| 核心观点 | 最重要的 1 到 3 条判断 |
| 关键逻辑 | 作者为什么这么说 |
| 我的判断 | 我认可 / 不认可什么 |
| 可行动点 | 对我有什么启发 |

不要用 `Table` 的情况：

- 内容本质上是连续论证
- 需要表达递进关系，而不是并列关系

## 13. 什么时候用 Block Quote

`Block Quote` 适合：

- 原文金句
- 要保留的作者原话
- 访谈、播客、论文的直接摘录

规则：

- 只保留最关键的一两句
- 引用下面最好补一句自己的判断
- 不要整段原文堆进去

## 14. 什么时候用 Monospaced

`Monospaced` 适合：

- 代码
- 命令行
- API 名称
- 字段名
- 需要与正文显著区分的术语

示例：

- `sf project retrieve start`
- `ProcessInstance`
- `External ID`

## 15. 链接怎么用

Apple Notes 支持网页链接，也支持笔记之间互链。

建议：

- 在单篇文章总结里，链接到“母版框架”
- 在主题笔记里，链接到具体单篇文章
- 在“延伸阅读”里，挂网页链接或相关笔记链接

目标是把 Notes 从散乱笔记，逐步变成知识网络。

## 默认输出模板

### 模板 A：文章总结

- `Title`
- `Heading`: 核心问题
- `Heading`: 核心观点
- `Heading`: 关键逻辑
- `Heading`: 我的判断
- `Heading`: 可行动点

### 模板 B：长期知识卡片

- `Title`
- `Heading`: 这是什么
- `Heading`: 为什么重要
- `Heading`: 适用边界
- `Heading`: 我的判断
- `Heading`: 相关链接

### 模板 C：主题研究

- `Title`
- `Heading`: 研究问题
- `Heading`: 现状
- `Heading`: 关键分歧
- `Heading`: 我的判断
- `Heading`: 下一步
- `Heading`: 延伸阅读

## 输出时的最后检查

输出前核对：

- `Title` 是否只出现一次，而且足够具体
- 长内容是否已经拆成可折叠区块
- `Subheading` 是否服务于复用，而不是凑层级
- 加粗是否只留下最值得扫到的地方
- 高亮是否只承担分类任务
- 列表、表格、引用、等宽文本是否都用于正确的关系
- 是否补了必要的判断，而不是只做信息搬运