个人技术笔记，按主题分目录存放 Markdown。同时是博客文章的唯一来源：push 到 main 后，.github/workflows/notify-blog.yml 会通知博客仓库增量同步，无需手动发布。
目录约定
<分类>/<标签>/.../文章.md 一级目录 = 博客分类，二级目录 = 标签（可省略）
img/ 所有图片，Markdown 里用相对路径引用：../img/xxx.png
思维导图/ XMind 等非 Markdown 资料，不参与同步- 文章标题取正文第一个标题，正文里的 `` 会被移除。
- 新增一级目录后，博客仓库的分类展示名表需要补一条，否则前台按目录名原样显示。
- 图片文件名建议有辨识度（如
campus-sandbox-01-overview.png），避免未命名.png撞名；单张控制在 2 MB 以内，长边不超过 2400 px。
写作注意
- Typora 默认把粘贴的图片存到本机用户目录，仓库里拿不到。请在偏好设置 → 图像里选「复制到指定路径」
../img，并勾选「优先使用相对路径」。 - 删除笔记不会自动删除线上文章，需要在博客后台处理。
- 改文章标题是安全的：同步按文件路径匹配，不会产生重复文章。
同步流程
flowchart LR
A[本机编辑笔记] -->|git push| B[personal-notes]
B -->|repository_dispatch| C[博客仓库 sync-notes]
C -->|变化的图片打水印后 rsync| D[服务器图片目录]
C -->|变化的 Markdown 写入数据库| E[线上文章]同步是增量的：以服务器记录的上次同步提交为基准做 git diff，只处理变化的 *.md 与 img/**。