Menu
Blog post format specification for this Astro site. Invoke when writing/creating/editing blog posts or when asked to write a blog/article.
| name | blog-writing |
| description | Blog post format specification for this Astro site. Invoke when writing/creating/editing blog posts or when asked to write a blog/article. |
Standard format for all blog posts in src/content/blog/. Follow these rules to ensure compatibility with the website.
Every blog post must start with --- delimited frontmatter.
---
title: "文章标题" # 必填，可包含 emoji
date: "2026-05-01" # 必填，日期必须加引号
time: "14:30" # 可选，24小时制，用于时段分类
pinned: 1 # 可选，数字越小越靠前
tags: # 可选
- 标签1
- 标签2
visibility: 公开 # 可选：公开 / 私密 / 草稿，默认公开
description: 文章摘要 # 可选，显示在文章列表
---
date 必须加引号：date: "2026-05-01" — 不加引号 YAML 会解析成 Date 对象导致 schema 报错---（三个减号），不能用 ***:，不是全角 ：#（YAML 行尾注释或整行注释）title → date → time → pinned → tags → visibility → description
##（二级标题）— CSS 会自动添加分割线#（一级标题），没有分割线###（三级标题）用于章节内的小分类## 章节标题 ← 有分割线
### 小标题 ← 无分割线，字号小于 ##
  缩进，不要敲空格   = 缩进两个汉字宽度  这是正文第一段，首行缩进了两格。
  第二段正文。段落之间空一行即可。
照片放在 public/images/ 中，引用路径为 /images/文件名.jpg。
推荐使用 HTML 语法（可控制宽度）：
<img src="/images/文件名.jpg" alt="描述文字" width="400">
Markdown 语法（不能调大小）：
width 不设 height，自动等比缩放<br><div style="text-align: center;">内容</div>Markdown 表格语法，网站 CSS 已添加边框和斑马纹。
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据 | 数据 | 数据 |
| 数据 | 数据 | 数据 |
表格前建议加一行描述文字。
用于替代 ASCII 艺术图。代码块语言标识为 mermaid，网站会自动渲染。
```mermaid
sequenceDiagram
actor 你
participant 服务器
你->>服务器: 请求
服务器-->>你: 响应
```
sequenceDiagram — 时序图（请求/响应流程）：
sequenceDiagram
actor 你
participant A
你->>A: 动作
A-->>你: 回复
graph LR — 从左到右流程图：
graph LR
A[节点A] --> B[节点B]
style A fill:#e74c3c,color:#fff
graph TD — 从上到下流程图/树形图：
graph TD
Root[根节点<br>换行说明] --> Child[子节点]
style Root fill:#27ae60,color:#fff
<br>style 节点ID fill:#颜色,color:#fff使用围栏代码块并指定语言：
```javascript
console.log("hello");
```
```bash
npm run dev
```
```text
# 纯文本内容
```
**加粗文字**
*斜体文字*
`行内代码`
- 无序列表项
1. 有序列表项
> 引用文字
鼓励使用 emoji 体现个人风格和语气。直接粘贴 Unicode emoji 即可。
简短描述-用关键词.md网页三件套-HTML-CSS-JavaScript到底在做什么.md在 frontmatter 中添加 time 字段，文章列表会自动显示时段标签：
| 时段 | 小时范围 |
|---|---|
| 凌晨 | 0:00-4:59 |
| 早晨 | 5:00-6:59 |
| 上午 | 7:00-10:59 |
| 中午 | 11:00-12:59 |
| 下午 | 13:00-17:59 |
| 晚上 | 18:00-21:59 |
| 深夜 | 22:00-23:59 |
不填 time 则无时段标签。
pinned: 1 # 数字越小越靠前
pinned: 2
pinned: 3
有 pinned 字段的文章出现在列表顶部"📌 置顶文章"区域。
每次创建新博客后检查：
---（不是 ***）date: "2026-05-01"（加了引号）:（不是全角 ：）##（不是 #）time: "14:30"pinned: 1npm run build 通过无报错