3.1 Frontmatter（YAML）#

1
---
2
title: 一句话说清这篇在讲什么（动词开头 or 名词短语）
3
published: YYYY-MM-DD
4
description: 2-3 句话概括全文覆盖内容，用顿号/逗号列举关键词
5
image: ../../assets/images/posts/<slug>.png
6
tags: ["标签1", "标签2", "标签3"]
7
category: 大类名
8
---

要求：

• title：不超过 35 个字，带冒号分隔「主题：副标题」或用动词开头
• description：包含关键技术名词，方便 SEO；不要写成 clickbait
• tags：3-6 个，混用中英文，跟随该词的通用叫法
• category：一个大类，如 Linux、VPS、Docker、AI

3.2 正文骨架#

1
开头（1-2 段）：痛点 + 这篇解决什么
2
  ↓
3
H2 一、整体概览 / 为什么需要这个（可选，视主题而定）
4
  ↓
5
H2 二～N、按操作顺序分步骤
6
  ↓
7
H2 踩坑清单 / 常见故障速查（倒数第二节）
8
  ↓
9
H2 可选进阶 / 几条实用经验（最后一节）

规则：

• 章节编号使用中文数字：一、二、三……十、十一……
• H2 是主章节，H3 是子步骤，例如 ### 3.1 下载脚本
• H4 极少使用，仅在 H3 下需要再分层时出现
• 不要出现 H1，H1 是文章标题，由框架渲染

3.3 开头段落的写法#

开头必须在 2 段内回答：

• 这个东西解决什么问题？
• 为什么默认状态不够好？

示例：

新 VPS 拿到手，几乎所有教程都跳过了一个事实：默认状态的 VPS 是不安全的——22 端口暴露在公网、密码登录开着、没有 fail2ban、内核 TCP 拥塞算法还是几十年前的 cubic。

特征：

• 用加粗强调核心论点
• 用破折号 —— 展开具体问题
• 不要以「大家好，今天我们来学习……」开头
• 不要以问句开头，例如「你是否遇到过……」

3.4 结尾段落的写法#

最后一节通常是「几条实用经验」或「可选进阶」，用无序列表收尾。

示例：

1
## 十四、可选进阶
2

3
跑完上面这些已经是合格的「安全 VPS」了。还有几样可以按需加：
4

5
- **2FA SSH**：用 google-authenticator-libpam
6
- **改 UFW 默认日志级别为 `low`**：`sudo ufw logging low`
7
- **VPS 监控**：哪吒 / Komari / Uptime Kuma

不要写「总结」或「本文介绍了……希望对你有所帮助」。直接在实用信息处结束。

4.1 代码块#

规则：

• 必须标注语言：bash、yaml、json、ini、toml、nginx、dockerfile、python 等
• 无法精确匹配的用 txt 或最接近的语言，例如 SSH config 用 sshconfig
• 代码块内注释用中文，写在命令上方或行尾
• 长命令拆成多行，每行一个逻辑单元
• 占位符用 <尖括号中文> 或 <ENGLISH_PLACEHOLDER> 格式

示例：

1
# 在你自己电脑上跑，不是在 VPS 上跑
2
ssh-keygen -t ed25519 \
3
  -C "your_email@example.com" \
4
  -f ~/.ssh/id_ed25519

4.2 表格#

表格是核心排版工具，用于：

• 命令速查：| 命令 | 作用 | 示例 |
• 参数对比：| 参数 | 默认值 | 建议值 | 说明 |
• 方案横评：| 方案 | 优点 | 缺点 | 适合场景 |
• 故障排查：| 现象 | 原因 | 解决 |
• 文件清单：| 路径 | 用途 |

表格规则：

• 列数 ≤ 5，超过就拆成多个表格
• 表头用中文
• 单元格内容尽量简短，一行内说清
• 不要在表格里放代码块，改用行内代码

4.3 Callout（引用块提示）#

使用 Markdown 引用块 > 加 emoji 前缀，共 3 种：

规则：

• emoji 只出现在 callout 前缀，正文中不使用任何 emoji
• 每个 callout 只讲一件事
• 警告类 callout 放在对应操作之前，先警告再给命令
• 一篇文章 callout 总数控制在 5-10 个，不要每段都加

4.4 Mermaid 图表#

使用 <div class="mermaid"> 包裹，不用 ````mermaid` 代码块。

支持以下图表类型：

规则：

• 节点文本用中文
• 每个图不超过 15 个节点，超过就拆分
• 节点内换行用 <br/>
• 边标签 -->|标签| 保持简短
• 一篇文章 1-3 个 Mermaid 图，不要每节都画

示例：

1
<div class="mermaid">
2
graph TD
3
  A[拿到 VPS] --> B[更新系统]
4
  B --> C[配置 SSH]
5
  C --> D[开启防火墙]
6
  D --> E[装 fail2ban]
7
  E --> F[开启 BBR]
8
</div>

4.5 加粗与强调#

规则：

• 加粗用于强调关键操作、关键概念、容易忽略的要点
• 每段加粗不超过 1-2 处，过多等于没有强调
• 不要用斜体，中文排版中斜体难看且无必要
• 不要用下划线
• 行内代码 ` 用于：命令名、文件路径、配置项、端口号、变量名

5.1 「为什么」先于「怎么做」#

每个操作步骤前，先用 1-2 句话解释为什么要这么做。读者需要理解动机，否则步骤只是死记硬背。

好例子：

chmod 700 ~/.ssh 是因为 OpenSSH 会主动拒绝权限过松的密钥目录——这是安全设计，不是 bug。

差例子：

执行以下命令修改权限：chmod 700 ~/.ssh

5.2 坑点单独标注#

踩坑经验不要藏在正文里，用 callout 或单独的「踩坑清单」章节集中呈现。

示例：

1
### 6.1 dd 后连不上
2

3
按这个顺序排查：
4

5
| 检查 | 命令 / 动作 |
6
|------|-------------|
7
| IP 没变？ | 在厂商面板确认 |
8
| 端口对不对？ | dd 默认 `22`；如果原系统是 `64400`，**新系统不会继承** |

5.3 敏感数据处理#

所有示例中的敏感信息必须替换为占位符：

5.4 不用图片#

所有需要视觉表达的内容，用以下方式替代：