大版本更新
一口气全面统一博客样式,移除部分冗余导航页面,更专注内容展示。
不因虚度年华而悔恨,不因碌碌无为而羞愧
博客系列第7期。用 Obsidian 写笔记,通过 Astro Composer 插件自动转换为博客内容,配合图床优雅发布。

简单说就是:用 Obsidian 写笔记 -> 自动转成博客文章格式 -> 推送到 GitHub -> 博客自动更新。
写文章的人不需要关心部署、构建这些事,只管在 Obsidian 里写就行。整个流程打通之后,写作体验非常丝滑。
这个方案适用于所有基于 Astro 的博客主题,包括 Mizuki、Firefly 等。
这个插件是 Obsidian 和 Astro 博客之间的桥梁,它能把 Obsidian 笔记自动转换成 Astro 能识别的 Markdown 格式。
Astro Composer 还没上架社区插件库,需要通过 BRAT 安装:
https://github.com/astro-modular/astro-composer安装后进入 Astro Composer 设置,有几个关键配置项:
Posts Folder — Obsidian 里放博客文章的文件夹
比如设成 Blog/Posts,以后所有要发到博客的笔记都放在这个文件夹下。
Astro Content Path — 本地 Astro 项目的 src/content 目录路径
比如 D:/MyBlog/Firefly/src/content,插件会把转换后的内容同步到这个目录。
Link Base Path — 博客的文章访问路径前缀
比如填 /blog,插件会自动把 Obsidian 内部链接转成博客友好的格式。
Creation Mode — 文章存储结构
推荐选 Folder-based with index.md,每篇文章一个文件夹,里面放 index.md。
Draft Management — 草稿管理
建议启用 Underscore Prefix,草稿文件会自动加下划线前缀(如 _my-draft.md),Astro 会忽略这些文件不发布。
写文章的时候图片怎么办?这就是图床派上用场的时候了。
这样图片不占项目仓库空间,加载速度也快。
配好之后日常使用就三步:
整个过程不需要手动去管 Astro 的文件格式、Frontmatter 这些,Astro Composer 都帮你处理好了。
Obsidian 有个 Obsidian Git 插件,可以设置定时自动 commit + push。配好之后你连 Git 命令都不用打,写完笔记保存,Obsidian 自动帮你推到 GitHub。
这样就实现了真正的「写完即发布」。
视频链接:BV1jWLH6cERQ
生成精美分享图或复制链接,与更多人分享本文。
最后更新于 ,距今已过 155 天
部分内容可能已过时