llm_wiki/wiki/读书笔记优化规范.md

categories, tags, created, source, type, aliases

categories	tags	created	source	type	aliases
LLM Wiki	wiki tool reading-notes standards clippings para	2026-05-23	读书笔记优化规范	tool	读书笔记规范 Reading Notes Standard

读书笔记优化规范

一套基于 PARA + LLM Wiki 架构的读书笔记版式优化标准，确保笔记结构清晰、可读性强、可关联。

---

定义

读书笔记优化规范是为 PARA 层 Clippings/ 目录中的读书笔记制定的版式标准，涵盖 frontmatter 规范、内容结构、Callout 使用、章节命名等方面。

目标：

• 提高笔记的可读性和可维护性
• 增强笔记间的关联性
• 统一 vault 内的笔记格式

---

核心要素

1. Frontmatter 规范

必填字段：

---
categories:
  - "[[读书笔记]]"
tags:
  - reading
  - {主题标签}
created: YYYY-MM-DD
---

可选字段：

---
rating: 1-5
author:
  - 作者名
via: ""
url: "{链接}"
topics: []
---

2. 内容结构规范

标准章节顺序：

1. 一句话总结（引用块）
2. 来源信息
3. 正文主标题
4. 章节内容（二级标题）
5. 总结表格
6. 延伸阅读

3. Callout 使用规范

类型	用途	示例场景
info	一般信息	核心观点、关键问题
tip	建议/技巧	实践建议、方法提示
warning	警告	风险提示、错误警示
danger	危险	严重后果、必须避免
important	重要信息	基本条件、核心原则
success	成功/积极	成功案例、正能量
quote	引用	金句、核心论断
example	示例	实际案例、应用场景

示例：

> [!info] 战略的核心问题
>
> 战略问题通常只跟两个问题有关：
> - 什么问题解决不掉，你会死？
> - 什么问题解决不掉，你无法赢？

4. 章节标题规范

❌ 不推荐：

## 一、什么叫战略？
## 二、作者的逻辑链（示意图）

✅ 推荐：

## 战略的定义
## 逻辑链

原则：

• 使用二级标题 ## 为主要章节
• 章节名简洁、描述性强
• 避免冗余前缀

5. 标签体系

分类标签（必填）：

• clippings - 标识为摘录类内容

内容类型标签（必填）：

• reading - 读书笔记
• article - 文章摘录
• post - 博客文章

主题标签（根据内容添加）：

• 通用：strategy、cognition、history
• 特定：mao-zedong、jinggangshan

命名规则：

• ✅ 小写、短横线连接
• ✅ 支持中文（英文优先）
• ✅ 支持嵌套：#personal/growth

---

使用流程

创建读书笔记

步骤：

1. 复制 Templates/读书笔记模板.md
2. 填写 frontmatter 必填字段
3. 编写一句话总结
4. 整理正文内容（按章节结构）
5. 添加 Callout 高亮关键观点（3-8 个）
6. 添加延伸阅读 wikilink

工具：

• Obsidian Web Clipper - 自动抓取网页内容
• defuddle CLI - 清除网页杂讯

定期优化

每周任务：

• 检查本周创建的读书笔记
• 添加缺失的 Callout
• 优化章节标题
• 添加相关 wikilink
• 更新标签

每月任务：

• 批量检查 frontmatter 完整性
• 统一标签命名规范
• 创建缺失的概念笔记

质量检查清单

Frontmatter：

• categories: [[Clippings]] 存在
• tags 包含 clippings 和 reading
• created 日期正确
• author、url 等可选字段填写

内容结构：

• 有一句话总结（推荐）
• 来源信息明确
• 章节标题简洁（无序号前缀）
• 使用 Callout 高亮关键观点（3-8 个）
• 列表缩进规范（3/6 空格）
• 有总结章节

可关联性：

• 添加延伸阅读章节
• 包含 3+ 个 wikilink
• 使用嵌套标签

---

实践案例

案例：读躬行客之《井冈山的战略》

文件位置：读躬行客之《井冈山的战略》.md

优化成果：

• ✅ 添加了 8 个 Callout 高亮
• ✅ 简化了章节标题（从"一、二、"改为简洁名称）
• ✅ 添加了延伸阅读章节（4 个 wikilink）
• ✅ 规范了 frontmatter 和标签

详见：读书笔记规范使用示例

---

相关工具

Obsidian 技能

• obsidian-markdown - Obsidian 语法支持
• obsidian-cli - 命令行工具
• defuddle - 网页内容清理

模板文件

• Templates/读书笔记模板.md - 完整模板
• Templates/Clipping Template.md - Clipping 模板

参考文档

• AGENTS.md - PARA + LLM Wiki 架构规范
• PARA - PARA 方法论

---

常见问题

Q: 为什么读书笔记要放在 Clippings 目录？

A: Clippings 是 PARA 层专门用于存放外部摘录（网页文章、书籍摘录等）的目录，符合 PARA 组织原则。

Q: Callout 应该使用多少个？

A: 建议 3-8 个，覆盖最核心的观点和关键信息。避免过度使用导致内容分散。

Q: 章节标题可以有三级标题吗？

A: 可以。二级标题 ## 为主要章节，三级标题 ### 为子章节，四级标题 #### 用于更细分的子章节。

Q: wikilink 指向的笔记不存在怎么办？

A: 可以先添加 wikilink（显示为红色），后续创建对应笔记时会自动关联。这是知识网络的自然生长方式。

---

版本历史

版本	日期	更新内容
1.0	2026-05-23	初始版本，基于"井冈山的战略"读书笔记优化制定

---

来源

溯源规则：所有数字/百分比/具体结论必须标注 [raw:{文件名}:{行号}] 格式。

• 读书笔记优化规范 - 完整规范文档（raw 层）
• 读书笔记规范使用示例 - 实际案例演示（raw 层）