Obsidian 工作流
用 Obsidian 写笔记，同步发布到你的博客网站。
用 Obsidian 写博客
Obsidian 是什么？
Obsidian 是一个本地笔记软件，可以理解为"高级版记事本"。它把笔记存储为 Markdown 文件（一种纯文本格式），保存在你自己的电脑上，而不是某个公司的服务器里。
很多知识工作者用它来管理个人笔记、知识库和写作。
这个模板和 Obsidian 是什么关系？
重要：这不是一个 Obsidian 插件。
这个博客模板只是支持 Obsidian 的文件格式。也就是说：
- 你用 Obsidian 写的笔记格式（比如
[[双链]]、图片引用方式），这个博客都能正确显示 - 你不需要安装任何 Obsidian 插件
- 你只需要把写好的文件放到博客项目的指定文件夹里
类比：Obsidian 是你的"笔"，博客模板是你的"出版社"。笔写出来的格式，出版社都认识。
工作流程（简单 4 步）
| 步骤 | 你做什么 | 发生了什么 |
|---|---|---|
| 1. 写笔记 | 在 Obsidian 里正常写文章 | 文件保存在你电脑上 |
| 2. 标记发布 | 在文章开头加几行配置信息 | 告诉系统"这篇要发布" |
| 3. 提交到 GitHub | 用工具把文件"上传" | 文件同步到云端 |
| 4. 自动发布 | 什么都不用做 | 网站自动更新，文章上线 |
默认把要发布的笔记放在 content/notes。如果你的笔记在其他目录，可以设置 OBSIDIAN_NOTES_DIR。每篇要发布的笔记都需要加一个发布标记：
---
publish: true
---
published: true 也可以，或者在正文里加 #publish 标签。
关于 Git 和 GitHub
- Git 是一个版本管理工具，可以理解为"文件的时光机"——它记录你每次修改了什么，随时可以回退
- GitHub 是一个在线平台，用来存放你的项目文件（类似"程序员的网盘"）
如果你完全不懂 Git，可以让技术同事帮你做初始设置，之后日常操作用 GitHub Desktop（一个图形界面工具）就能完成，不需要敲命令。
图片怎么处理？
把图片放在 Obsidian 笔记库的指定文件夹里即可。博客系统会自动识别 Obsidian 的图片引用格式（![[图片名.png]]），正确显示在网站上。
链接怎么处理？
Obsidian 的双向链接格式 [[另一篇笔记]] 会被自动转换为博客内的正常链接。你不需要手动修改。
适合谁用？
| 适合 | 不太适合 |
|---|---|
| 已经在用 Obsidian 写笔记的人 | 不想在电脑上装软件的人 |
| 喜欢本地写作、离线可用 | 只想打开浏览器就写的人 |
| 希望笔记和博客打通 | 对文件管理感到头疼的人 |
| 有技术同事可以帮忙初始设置 | 完全没有人帮忙搞技术的人 |
如果你觉得这个方式太复杂，直接用后台写作就好，参见 发布文章 页面。