博客上线了!这是第一篇,主要用来验证整套发布链路是否正常工作:Obsidian 写 Markdown → git push → 服务器自动构建 → 公网 HTTPS 访问。
这套站怎么搭的
技术选型很轻量:
- 写作端:Obsidian,所有内容都是纯 Markdown 文件
- 生成器:Quartz v5,原生支持 Obsidian 语法(
[[双链]]、![[嵌入]]、callout 等) - 托管:自建 Gitea,源码就是博客源
- 部署:Gitea 的
post-receivehook,push 后服务器自动npm ci+npx quartz build,再 rsync 到 web 根目录 - Web 服务:Caddy 自动签发 HTTPS 证书
完整的发布动作只有一条命令:
git add . && git commit -m "新文章" && git pushpush 完十几秒后刷新页面,内容就上线了。
验证各种渲染
图片(Obsidian 嵌入语法)
下面这张图用 Obsidian 的 ![[placeholder.png]] 嵌入语法,Quartz 默认插件会正确解析:

Callout
这是一个 Note 类型的 Callout
Obsidian 风格的提示框,Quartz 原生支持。
也可以折叠
> [!tip]- 折叠标题(标题后加-默认折叠)
代码块
def hello(name: str) -> str:
return f"Hello, {name}!"
print(hello("世界"))双链
列表与任务
- 博客框架搭建完成
- 自动部署流水线跑通
- 写更多内容……
接下来
这个博客主要是给自己用的——记录开发经验、AI 工程的实践和踩坑。如果某天你(未来的我,或者随便哪个访客)看到了这里,希望这些笔记对你也有用。
下一篇见 🚀