从 Obsidian 到线上：我的 Hugo 发布脚本是如何工作的

Sat, 22 Aug 2026 23:35:56 +0800

这个站的文章发布，现在只需要在本地跑一条命令：

./publish.sh my-note.md

这篇文章记录这个脚本的工作原理，以及它和 Obsidian 的配合方式。

为什么不用 git，也不用 CMS

静态博客的常见发布方式有几种：git push 触发 CI、网页版 CMS、或者 Hugo 自带的 hugo deploy。我的场景有点特殊：写作在本地 Obsidian 里完成，服务器是自己的一台 VPS，中间不想引入第三方平台。那么最朴素的方案反而是最合适——scp 把文件传上去，ssh 触发服务器上现成的部署脚本。不需要守护进程，不需要 webhook，不需要在服务器上装任何新东西。

脚本做了什么

publish.sh 按顺序做七件事，任何一步失败都会中止，线上内容保持原样：

定位正文。 接受一个 .md 文件或一个目录。如果是目录，约定正文叫 index.md——这是 Hugo 的 page bundle 结构，文章和它的图片放在同一个文件夹里，作为一个整体发布。
生成 slug。 URL 取自文件名：剥掉 2026-08-22- 这样的日期前缀，转小写，非法字符转成连字符。Obsidian Hugo Publish.md 变成obsidian-hugo-publish。纯中文文件名会报错退出——这是有意的，URL 里的拼音或机器翻译都不如一个自己起的英文 slug 体面。
校验 front matter。 检查 title 存在；检查正文里没有 Obsidian 的 wiki 图片语法 ![[...]]（Hugo 不认识它）。
校验图片。 扫描正文里所有 ![](...) 引用，确认每一个本地图片文件都真实存在。少了图片就中止——线上出现裂图比不发更糟。
补齐 date。 所有校验通过后，才往 front matter 里补 date。顺序很重要：先校验后改文件，失败的文章不会被留下修改痕迹。
组装并上传。 把正文和被引用的图片拷进一个临时目录，组成 content/notes/<slug>/ 的结构，scp 整包传上服务器。
触发部署，回写状态。 ssh 到服务器执行 deploy.sh（构建 → 同步到 nginx 目录 → reload)，最后把 Obsidian 笔记里的 status: 改成published。

和 Obsidian 的配合

在每篇笔记的 Properties 里维护一个 status 字段（idea / draft / published)，配合 Dataview 插件拉一张表就是内容流水线看板：哪些是想法，哪些在写，哪些已发布。脚本发布成功后会自动把这个字段改成 published，看板不需要手动维护。

最终测试

Mon, 29 Sep 2025 01:14:34 +0800

这是最终测试文章。

测试部署演示

Sat, 27 Sep 2025 22:28:56 +0800

这是一个测试文章，用于演示博客的自动化部署流程

My 1st post

Tue, 15 Sep 2020 11:30:03 +0000

Desc Text.