最近把自己博客系统整理了一下,顺手开源出来:一个极简静态博客,日常只需要写/改 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(不强依赖)

图片展示

image
image

构建方式(只有一种)

这个项目只支持一种构建方式

你提交文章 → 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。