这是一篇示范文章,用来说明本博客的 frontmatter 规范。新建文章时复制下面的字段即可。
frontmatter 字段
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
title | 是 | string | 文章标题 |
description | 是 | string | 摘要 / SEO 描述 |
pubDate | 是 | date | 发布日期,如 2026-05-26 |
updatedDate | 否 | date | 更新日期 |
heroImage | 否 | image | 头图,放 src/assets/ 下相对引用 |
tags | 否 | string[] | 标签,默认 [] |
draft | 否 | boolean | 草稿,默认 false;为 true 时不出现在列表与首页 |
写作约定
- 文件放在
src/content/blog/,扩展名.md或.mdx。 - 文件名即 URL slug(如本文
/blog/example-post/)。 draft: true的文章本地可预览,但不会出现在博客列表、首页最近文章与 RSS 中。