最近把自己博客系统整理了一下,顺手开源出来:一个极简静态博客,日常只需要写/改 posts/ 里的 Markdown,剩下的全部交给 GitHub Actions(actions bot)自动构建。
地址:👉NIE-Higan-Blog
这玩意能干啥?
- ✅ 只写 Markdown:文章放
posts/,支持 YAML Front Matter - ✅ 自动生成首页索引:生成
posts.json(SPA 首页读这个渲染列表) - ✅ 自动生成站点地图:生成
sitemap.xml - ✅ 每篇文章自动生成独立静态页:输出到
/p/<slug>/index.html
这样搜索引擎/分享链接都更友好(SEO/预览/直链) - ✅ 评论可选:可接 Waline(不强依赖)
图片展示


构建方式(只有一种)
这个项目只支持一种构建方式:
你提交文章 → GitHub Actions 自动运行 build → 自动生成产物并由 actions bot 提交回仓库
你不需要在本地装任何东西,也不需要手动执行脚本。
写作方式(两种都行)
方式 A:先在本地写好 Markdown,再复制进仓库
- 本地写
.md - 上传/复制到仓库
posts/ - 提交后自动构建
方式 B:直接在 GitHub 网页里写
- 打开
posts/ - 新建/编辑文件
- 提交后自动构建
文章格式
文件命名建议
普通文章建议用:
YYYY-MM-DD-文章标题.md
Front Matter(支持 top 排名)
文章顶部可以写:
---
title: 文章标题
date: 2026-02-06
category: 分类
tags: [标签1, 标签2]
top: 10
---
其中:
top是文章排名:数字越大越靠前
例如top: 100会排在top: 10前面
「说说」的特殊规则
我把“说说”当成一种特殊分类,规则固定:
文件名必须是
YYYY-MM-DD-说说.md
文件最顶部固定写
---
title: 说说
date: YYYY-MM-DD
category: 说说
---
然后下面直接写正文内容即可,例如:
---
title: 说说
date: 2026-02-06
category: 说说
---
今天又在折腾 VPS,把 DNS 搞炸了……
欢迎围观/提建议
仓库:👉NIE-Higan-Blog
如果你也喜欢这种“只写 Markdown、其余全自动”的方式,欢迎点个 Star 或提 PR。
