技术笔记:一个 .gisthub/ 文件夹就是全部内容 📂

GistHub 没有自己的后台编辑器。 你的全部内容,就是仓库根目录的一个 .gisthub/ 文件夹。

结构长这样(完整规范在项目 docs/SPEC.md):

.gisthub/
  config.yml        # 项目名、描述、主题色
  posts/            # 图文笔记,按日期目录组织
    2026-08-01-hello/
      index.md      # frontmatter + Markdown 正文
      images/       # 图片放这里,正文用相对路径引用
  changelogs/       # 更新日志,格式和 posts 一样

每篇笔记就是一个带 YAML frontmatter 的 Markdown:

---
title: "新功能上线"
date: 2026-08-01
type: photo        # photo | update | note
cover: images/cover.jpg
tags: [feature]
author: "octocat"
---

几个实现细节:

• 发现机制:通过 GitHub Contents API 列出 posts/ 和 changelogs/ 目录,不需要 manifest 文件,目录名带日期前缀天然按时间排序
• 图片渲染:正文里的相对路径图片会被解析到 raw.githubusercontent.com;私有仓库图片走 /api/image 代理鉴权后返回,不会泄漏直链
• Markdown 解析用 gray-matter + remark
• 网页里内置了 Skills 工具箱,可以直接初始化 .gisthub/、创建图文笔记和更新日志,不用手写

写一次 Markdown,GitHub 里是文档,GistHub 里是小红书笔记 📝