基础篇：Obsidian 日常发布工作流：写完笔记，一键更新个人网站
说明如何通过 Obsidian 插件完成本地写作、发布时检查、附件同步和一键发布，无需下载源码、无需命令行也能更新个人网站。
文章目录11 个章节
如果您想把 Obsidian 笔记发布成个人网站，一上来就面对源码、命令行和复杂部署文档，体验会很割裂。
我现在重新思考这套系统时，越来越确定一件事：源码可以开源，但日常使用入口不该是“下载源码”。
更顺手的体验其实很直接：
我继续在 Obsidian 里写 Markdown，需要公开时点一下发布，网站就更新。
这篇文章专门说明一条更顺手的发布路径：继续在 Obsidian 写作，通过插件完成预览、检查和发布。
1. Obsidian 仍然是本地写作入口
内容的源头放在您自己的 Obsidian Vault 里，这个取舍很重要。
文章、图片、图表、公式、项目记录和学习笔记都保存在本地文件夹里：
Obsidian Vault
├── articles
├── projects
├── growth
├── attachments
└── profile这意味着内容不是写在某个在线后台里，也不是交给某个平台保存。插件可以坏，服务器可以换，主题可以重做，但 Markdown 文件还在。
本地 Markdown 文件才是原始资产。
网站只是发布形态。
2. 从本地笔记到网站更新
Obsidian 本身适合写作和组织笔记，但它不是完整的网站发布系统。它解决“写在哪里”，没有完整解决“怎么稳定发布出去”。
插件连接的是从“本地笔记”到“公网网站”之间的那段流程：
您看到的是一个连续动作：写完，然后点击发布。校验、同步、构建和索引更新由系统在发布过程中完成，不需要每天记一串命令。
这就是插件在日常写作里的价值。
3. 首次配置只做一次
第一次配置可以稍微认真一点，但它更像绑定发布目标，不该变成一份运维手册。
只需要填几项关键信息：
- 服务器地址
- 发布 Token
- 站点名称
- 默认公开或草稿
- 附件同步策略
配置完成后，日常写作就回到 Obsidian 本身。
4. 写完文章后，发布过程很短
日常使用时，可以把发布理解成一个很短的确认动作。
在 Obsidian 里写完一篇文章后，确认内容可以公开，然后点击发布。
发布过程中会检查容易遗漏的地方：
- 如果标题、摘要或发布时间没填，直接在 Obsidian 里提示
- 如果标签写法不一致，可以从已有标签里选择
- 如果文章属于某个系列、某个探索方向，可以进行填充或者选择
- 如果图片或附件不存在，可以在发布前提醒
- 如果文章还是草稿，可以避免误发到公开站
5. 发布时自动检查
点击发布后，系统会先检查：
- 标题是否存在
- slug 是否合法
- 发布时间是否正确
- 标签是否为空
- 系列顺序是否冲突
- 草稿是否误设为公开
- 图片附件是否存在
- 是否包含不该公开的敏感内容
在 Obsidian 里就会有清晰提示，修完后再次点击发布。比如少了标题、slug 重复、图片不存在，都会提示。
6. 一键发布到个人服务器
最省心的版本里，只需要在插件里填写几项东西：
- 服务器地址
- 发布 Token
- 站点名称
- 是否公开发布
发布时，Markdown 和附件会同步到服务器。
服务器负责后续事情：
- 接收内容
- 保存原始 Markdown
- 运行内容校验
- 构建静态网站
- 生成搜索索引
- 切换到最新版本
日常使用时，不需要知道服务器内部怎么做。服务器会处理构建、索引、备份和发布切换，这些是系统能力，不是每天写作时的负担。
只需要知道：发布成功后，网站已经更新。
7. 服务器也可以作为远程知识备份
这套系统不只是在服务器上放一个网站。长期用下来，这个区别会变得很明显。
它也可以把服务器变成一个轻量远程知识云盘：
- Markdown 原文
- 图片附件
- Excalidraw 源文件
- 数学公式和图表内容
- 项目文档
- 学习资料
本地 Vault 是第一份资产，个人服务器是第二份资产。公开页面只是其中一个结果。
公开网站展示整理后的内容，服务器同时保存原始文件和附件。
这样即使某个平台不可用，自己的内容仍然在本地和服务器上。
8. Git 备份是可选增强，不是使用门槛
Git 很适合版本管理，我自己也认可它的价值。但如果把 Git 放到第一步，很多人会被挡在门外。
完全可以不配置 Git，只用插件发布。
需要版本历史的人，再开启 Git：
Git 所扮演的角色其实是：
- 记录历史
- 备份内容
- 支持回滚
- 支持多设备同步
9. 内容始终可以迁移
插件化发布不等于把内容锁进插件。
Markdown
Frontmatter
附件只要这些原始文件还在，未来就可以迁移到：
- Hugo
- Astro
- Jekyll
- MkDocs
- GitBook
- GitHub 仓库
- 其它 Markdown 工具
插件只是让发布更省心，不改变内容资产的开放性。哪天不用这套系统了，也能把 Markdown 拿走。
10. 适合哪些人
这种工作流适合这些场景：
- 程序员：记录工程实践、部署经验、项目复盘
- 科研人员：记录论文阅读、实验过程、公式推导
- 研究生和博士生：整理长期研究方向和阶段成果
- 独立开发者：沉淀作品迭代、技术方案和公开项目
- Obsidian 写作者：想把本地笔记变成可访问的网站
11. 一句话总结
这条主路径可以概括为：
本地写作，点击发布，自动检查并更新到个人服务器。