← 返回博客

示范文章:frontmatter 规范

#示范#约定

这是一篇示范文章,用来说明本博客的 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 中。