怎么写一篇新文章（给自己看的备忘）
335 字
2 分钟
怎么写一篇新文章（给自己看的备忘）
AI 摘要
两种写法
- 控制台：
pnpm console→ 文章 → 新建，左边写 Markdown 右边实时预览，右侧填元数据，Ctrl+S 保存。 - 直接写文件：在
src/content/posts/下新建.md，文件名就是 URL 的一部分（中文名也可以，但建议用英文）。
frontmatter 字段
| 字段 | 类型 | 说明 |
|---|---|---|
title | string | 文章标题（必填） |
published | date | 发布日期。只写日期就写 2026-11-12；要写具体时间必须带时区，如 2026-11-12T21:30:00+08:00（不写偏移会被当成 UTC，展示时差 8 小时） |
updated | date | 更新日期，可选 |
draft | bool | true 时只在本地产出，不进列表 |
description | string | 摘要，列表页和 SEO 都用它 |
image | string | 封面图，相对 src/content/posts/ 的路径 |
tags | string[] | 标签数组 |
category | string | 分类，一个文章一个 |
pinned | bool | 置顶 |
series / seriesOrder | string / number | 系列名与序号 |
comment | bool | 是否开评论 |
password / passwordHint | string | 加密文章 |
可用的 Markdown 扩展
- 代码块自动高亮 + 行号 + 复制按钮
- 数学公式：
$E=mc^2$与$$...$$ - 提示块、折叠块、GitHub 卡片、文件树等自定义指令（见主题文档）
- 图片直接放
src/content/posts/images/或用媒体库上传到public/
一些小约定
- 一篇文章只放一个
## 一级小节主题，TOC 才不会长到离谱 - 代码块写明语言，否则高亮会降级成纯文本
- 图片压缩到 200KB 以内，站点是静态的，体积直接影响首屏
怎么写一篇新文章（给自己看的备忘）
https://lovelydazai-blog.pages.dev/blog/writing-guide/