写作与图片规范

写任何内容都先过一遍这份规范，能避免 80% 的发布事故。

Front Matter 必填

• 所有内容：title、date、description、tags
• 博客文章（_posts/）另加 categories
• 笔记本笔记另加 collection（profile=notebook，id=对应笔记本）

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 博客文章示例
title: 影评：××
date: 2026-09-20 20:00
description: 一句话
categories: [影评]
tags: [影评, 电影/科幻]
---
# 笔记示例
title: ××
date: 2026-09-20 20:00
tags: [CTF/Pwn, CTF/栈溢出]
collection:
  profile: notebook
  id: ctf-notes

命名与网址

• 文件名=网址：博客 /posts/文件名/，笔记 /notebooks/<id>/<文件名>/，Wiki /wiki/site-guide/<文件名>/；
• 新文件建议用英文短横线（中文文件名能用但地址长且易乱码）；
• 发布后别改文件名，否则旧链接失效。

图片：只用一种写法（Typora 友好）

1. 图片放进与 md 同名的文件夹（Typora 粘贴会自动创建并存进去）；
2. md 里保留 Typora 生成的相对路径，例如 {% asset_img "图片.jpg" "" %}；
3. 发布时自动转换，你什么都不用改：
   • 博客文章 → hexo-image-link 转 asset_img；
   • 笔记本笔记 → scripts/fix-notebook-images.js 转绝对地址；
4. 封面 cover 是 Front Matter，写绝对路径（/posts/… 或 /notebooks/<id>/<文件名>/…）；
5. 别用 ../ 父目录相对引用；单张图建议压到 500KB 以内再传。

标签：用斜杠做层级

CTF/Pwn、日记/2026-09、课程/操作系统 这类写法会自动生成层级与筛选页；同一主题的父级保持稳定（完整清单见标签体系）。

【待填：你的个人写作习惯 / 常用开头模板 / 校对清单】