这六条我全犯过。改掉之后，笔记才从"垃圾堆"变成"可检索资产"。

1. 截图代替文字

搜不到、复制不了、链接会过期。能打字的一律打字，实在要图，图下面补一行文字说明。

2. 不放寄存器地址

写"配置 XXX 寄存器"等于没写。要写成：

寄存器 0x01 (BMSR)
  bit5  Auto-Negotiation Complete
  bit2  Link Status

半年后你自己会感谢自己。

3. 不写复现步骤

"昨天那个 bug 又出现了" —— 哪天昨天？什么环境？

固定格式：环境 / 步骤 / 预期 / 实际。四行搞定，省掉将来两小时。

4. 结论不置顶

技术笔记不是小说，别搞悬念。第一行就写结论，理由往后放。

5. 命名随心所欲

✗ 笔记.md  / 新建文档(2).md  / aaa.md
✓ 2026-09-20-ethernet-link-troubleshooting.md

日期前缀 + 英文短横，排序、检索、当 URL 都能用。

6. 从不回头修订

笔记写完就扔，等于没写。我的做法：每解决一次同类问题，就回去往原文件补一行"2026-10 补充：还有一种情况是……"。

笔记的价值不在于你写了多少，而在于将来那次你正好搜到了它。

效率Markdown工具