当我们使用 Hugo 搭建博客的时候,一般都需要经过创作文章 -> 本地生成静态文件 -> Push 站点等多个步骤,如何高效一体化这个过程,让我们的精力主要集中在博客创作上?在借鉴前人的基础上,这里为大家整理下我个人的一个创作实践。

I. 前提条件

本文不涉及 Hugo 博客搭建,可参考如下搭建教程:

参考1 👉 Hugo 静态网站部署 | Mortal

参考2 👉 Hugo PaperMod 安装与配置 | Mortal

II. 相关应用

1.1 Obsidian

Obsidian 是一款免费非开源的 Markdown 创作工具,借助其丰富的插件市场,可一体完成从文章创作到部署的全过程。

1.2 相关插件

💡 Tips : 某些地区“社区插件市场”可能无法直接访问,请自行解决科学上网问题。

  1. 打开 Obsidian ⚙️(选项) -> 第三方插件 -> 关闭安全模式(首次安装需关闭) -> 社区插件市场,搜索并安装以下插件:
名称用途
QuickAdd使用自定义模板快速创建文章
Linter自动生成创建时间,自动更新编辑时间
Git在 Obsidian 中自动提交、拉取、推送并查看更改
  1. 安装插件后记得启用插件。

III. 一体化实践

参考1👉 Obsidian+github+clouflarepages的Hugo一体式发布流程 | Drifting Boats

参考2👉 把 Obsidian 变为 Hugo 博客的集成管理平台 | 胡说

3.1 创建 Posts 模板

在 Obsidian 仓库根目录创建一个“模板文件夹”,如:templates ,在模板文件夹下创建 2 个模板文件,参考如下:

文章模板:add_posts.md

 1---
 2title: {{name}}
 3slug: 
 4url: 
 5categories: 
 6tags: 
 7draft: true
 8date: 
 9lastmod: 
10---

说说模板:add_moments.md

1---
2title: {{name}}
3slug: 
4tags: 
5date: 
6lastmod: 
7---

💡 Tips : 可按需增减 frontmatter 字段。

3.2 创建 QuickAdd 模版

3.2.1 添加模板

Pic_2025-04-01_225057.png

配置说明:

  1. 指定模板文件夹路径:与 3.1 节模板文夹路径一致。
  2. 输入模板名称。
  3. 添加至列表。
  4. 点亮闪电图标(启用模板)。
  5. 配置模板。

3.2.2 配置模板

3.2.2.1 模板 1

文章目录结构 1 :

1├── content/
2│  ├── posts/
3|    ├── post1.md
4|
5|    ...
6|
7|    ├── post2.md
8|    ├── _index.md

配置参考:

Pic_2025-04-01_230522.png

配置说明:
6. Template Path : 与 3.1 节模板文路径一致。
7. File Name Format : 启用✅
8. File Name : {{name}}
9. Create in folder : 启用✅
10. Choose Folder when creating a new note : 启用✅

其它项按需配置,在这样的配置下,使用名为 add post 模板,QuickAdd 将在你选择的目录下创建一个 {{name}}.md 文件,其中 {{name}} 为使用 QuickAdd 时输入的文件名。

3.2.2.2 模板 2

文章目录结构 2 :

 1├── content/
 2│  ├── posts/
 3|    ├── post1/
 4|      ├── index.md
 5|      ├── pic1.png
 6|      ├── pic2.jpg
 7|
 8|    ...
 9|
10|    ├── post2/
11|      ├── index.md
12|    ├── _index.md

配置参考:

Pic_2025-04-06_171025.png

配置说明:
6. Template Path : 与 3.1 节模板文路径一致。
7. File Name Format : 启用✅
8. File Name : {{name}}/index
9. Create in folder : 启用✅
10. 输入文章存储路径,如:content/posts
11. 添加路径。

其它项按需配置,在这样的配置下,使用名为 add post 模板,QuickAdd 将在指定目录 content/posts/{{name}} 下创建 index.md 文件,其中 {{name}} 为使用 QuickAdd 时输入的文件名。

3.2.3 设置快捷键(可选)

Pic_2025-04-06_231512.png

添加 QuickAdd: Run QuickAdd 快捷键。

3.3 配置 Linter

3.3.1 基础配置

Pic_2025-04-06_181154.png

根据个人习惯,选择“保存时格式化文件”,或“文件修改时格式化文件”,或两者同时选择。

📢 注意:建议把“模板文件夹”加入忽略文件夹,这样在修改模板文件时就不会自动更新模板文件中的日期元数据。

3.3.2 时间戳配置

Pic_2025-04-06_212524.png

在 YAML 标签中,找到 “YAML 时间戳”并启用:

  • 创建日期键名:date
  • 修改日期键名:lastmod
  • 格式:(删除默认值,留空)

3.4 新建 Posts

Pic_2025-04-06_232905.png

新建“文章”或“说说”,并修改相关的 frontmatter 信息。

3.5 配置 Git (可选)

Pic_2025-04-06_230739.png

根据需要配置 Git 自动提交、同步间隔、启动拉取等。

3.6 自动部署

Git 推送后,等待托管平台自动部署完成(前提:已完成相关平台自动部署配置)。

IV. 参考文档

  1. Drifting Boats

  2. 胡说