关于这本手册
为什么做它
网上关于 Obsidian 的教程不少,但多数是「功能罗列」:这个按钮能干什么、那个菜单有什么。看完还是不知道明天早上该点哪里。
这本手册按你要做的事来编排:
- 不是「Notebook Navigator 有哪些功能」,而是「怎么在三个项目之间一秒切换」
- 不是「属性支持哪些类型」,而是「哪四个字段值得填,其余别填」
- 不是「支持多少种搜索语法」,而是「找一个上周改过的合同,命令怎么写」
写法上的三条自我约束
每节只解决一件事 —— 一节里塞三个主题,读者一个都记不住
步骤给最短路径 —— 三步能做完的,不写十步的「完整流程」
结论要给判据 —— 「什么时候该用」比「怎么用」更重要
适用与不适用
| 适合 | 不适合 |
|---|---|
| 刚装 Obsidian,界面还是默认样子 | 想找插件开发文档 |
| 已经在用,但笔记越存越乱 | 想要 Markdown 语法教程 |
| 想在手机和电脑之间同步 | 想找 Obsidian 官方功能全表 |
| 想把工作流固定下来 | 想找主题美化大全 |
内容维护
| 项 | 做法 |
|---|---|
| 加一节 | 写一个 Markdown 文件,加进侧边栏 |
| 改一处 | 改那一行,重新构建 |
| 部署 | 一条命令推到 Cloudflare Pages |
| 服务器 | 无 |
| 费用 | 免费额度内 |
技术栈
- VitePress —— 静态站生成
- Cloudflare Pages —— 托管与 CDN
- Obsidian + Notebook Navigator —— 手册所讲的对象