之前用 Hexo 搭过博客，每次写完要 hexo g && hexo d，步骤多，开两个窗口来回切。这次换一种方式：用 Obsidian 写文章，push 到 Gitee，Webhook 自动触发服务器构建部署。
这一篇先讲写作环境的搭建。
一句话总结：下载 Obsidian → 建 Git 仓库 → 配 Gitee SSH → push 完事。
先看选型
| 环节 | 选择 | 为什么选它 |
|---|---|---|
| 写作 | Obsidian | 本地 markdown，离线可用，双链方便 |
| 代码托管 | Gitee | 国内访问快，有 Webhook |
| 静态生成 | Python 自写 | Hugo 国内网络装不上，需求也不复杂 |
| 部署 | Nginx 自托管 | 已有云服务器，复用 SSL |
选型思路很简单：能不依赖第三方平台就不依赖。 用自己的服务器、走自己的域名，出了问题自己能修。
目录结构
blog/
├── .obsidian/ # Obsidian 配置（自动生成）
├── posts/ # 文章（markdown）
├── assets/ # 图片附件
├── .gitignore
└── README.md
七步走
第一步：建 Obsidian 仓库
mkdir -p /path/to/blog
Obsidian 打开这个目录，选"打开文件夹作为仓库"。它会自动生成 .obsidian/。
我在 app.json 做了几个小调整：
{
"foldHeading": true,
"showLineNumber": true,
"spellcheck": false
}
文章放 posts/，附件放 assets/，就这么简单。
第二步：初始化 Git
git init
git config user.name "YourName"
git config user.email "email@example.com"
加 .gitignore 排除 Obsidian 的临时文件：
.obsidian/workspace
.obsidian/cache
.obsidian/plugins/
Thumbs.db
.DS_Store
第三步：创建 Gitee 仓库
Gitee 上新建一个空仓库，不要勾选"初始化仓库"。然后：
git remote add origin git@gitee.com:username/blog.git
第四步：配 SSH 密钥
Windows 上生成：
ssh-keygen -t ed25519 -C "gitee-blog" -f ~/.ssh/id_ed25519_gitee
公钥加到 Gitee → 设置 → SSH 公钥。然后配 SSH config：
Host gitee.com
HostName gitee.com
IdentityFile ~/.ssh/id_ed25519_gitee
User git
不配好 SSH config，每次 push 都要输密码。 一次性配好省半年的事。
测试：
ssh -T git@gitee.com
# Hi username! You've successfully authenticated...
第五步：推送
git add -A
git commit -m "🎉 初始化博客仓库"
git push -u origin master
第六步：文章格式
每篇文章建议加上 frontmatter：
---
title: 文章标题
date: 2026-06-12
tags: ["F5","DevOps"]
description: 一句话摘要
---
正文内容...
不写也行，构建脚本会自动用文件名和时间兜底。
第七步：日常写作
用 Obsidian 直接编辑 posts/ 下的 markdown 文件。写完：
git add -A && git commit -m "新文章：xxx" && git push
三个命令，一次搞定。
配合下篇食用更佳
下篇讲 Webhook 自动部署：push 完等几秒，浏览器刷新看效果。
你的博客用的什么工作流？ 评论区聊聊，互相抄作业。