用 Markdown 写博客,用 Git 发布
#站点#写作
有人问这个站是怎么更新的。其实没有后台,也没有在线编辑器,流程只有三步。
写:本地 Markdown
每篇文章就是一个 .md 文件,放在仓库的文章目录里。文件名会变成文章的 URL,开头一段 frontmatter 填标题、摘要、日期和标签:
---
title: 文章标题
description: 列表页和分享卡片用的摘要
pubDate: 2026-09-13
tags: ['标签一', '标签二']
---
正文就是普通的 Markdown,代码块会自动高亮。想改哪篇就打开哪个文件,改完保存,不需要登录任何后台。
建:本地生成静态页面
站点用 Astro 构建。npm run build 会把 Markdown、页面模板和图片一起编译成一组静态 HTML,输出到 dist/。
这一步在本地完成,服务器不参与。好处是构建失败会当场发现,而不是部署完才看到白屏。
发:用 Git 推产物
源码和产物分两条分支:源码进 main,构建出来的 dist/ 进 deploy。服务器只拉 deploy,Nginx 指向那个目录。
npm run build
git add dist && git commit -m "post: 新文章"
服务器上:
git fetch origin deploy
git reset --hard origin/deploy
第一次配置稍麻烦,之后每次发文章都只是这几条命令。
为什么不用现成的博客平台
用过,也写过。平台省事,但样式、归档和以后想加的东西都受限于别人。自己搭一套,前期多花一点时间,换来的是想怎么改就怎么改。
代价是没有评论和现成的编辑器。对我这种写得不多、改得不少的人来说,这笔账还算划算。