← 返回博客

示范文章:frontmatter 规范

#示范#约定

这是一篇示范文章,用来说明本博客的 frontmatter 规范。新建文章时复制下面的字段即可。

frontmatter 字段

字段必填类型说明
titlestring文章标题
descriptionstring摘要 / SEO 描述
pubDatedate发布日期,如 2026-05-26
updatedDatedate更新日期
heroImageimage头图,放 src/assets/ 下相对引用
tagsstring[]标签,默认 []
draftboolean草稿,默认 false;为 true 时不出现在列表与首页

写作约定

  • 文件放在 src/content/blog/,扩展名 .md.mdx
  • 文件名即 URL slug(如本文 /blog/example-post/)。
  • draft: true 的文章本地可预览,但不会出现在博客列表、首页最近文章与 RSS 中。