本文介绍博客文章 frontmatter 支持的所有字段及其用法。

必填字段

title

文章标题，必填字段。

YAML
UTF-8 · 1 Lines
title: 我的文章标题

description

文章描述，用于 SEO 和文章列表展示，必填字段。

YAML
UTF-8 · 1 Lines
description: 这是一篇关于某个主题的文章。

date

文章发布日期，必填字段。支持多种日期格式：

YAML
UTF-8 · 3 Lines
date: '2026-01-15'
date: 'Jan 15 2026'
date: '2026-01-15T10:30:00'

可选字段

updatedDate

文章更新日期，可选字段。格式与 date 相同。

YAML
UTF-8 · 1 Lines
updatedDate: '2026-02-20'

heroImage

文章封面图片，可选字段。支持本地图片路径或远程 URL。

YAML
UTF-8 · 2 Lines
heroImage: './cover.jpg'
heroImage: 'https://example.com/image.jpg'

draft

是否为草稿，可选字段，默认为 false。设置为 true 时，文章不会在生产环境显示。

YAML
UTF-8 · 1 Lines
draft: true

文章短链接标识，可选字段。用于生成友好的 URL，如 /blog/my-article/。

YAML
UTF-8 · 1 Lines
abbrlink: my-article

badge

文章徽章标签，可选字段。显示在文章标题旁边，用于标记文章状态或类型。

YAML
UTF-8 · 3 Lines
badge: Astro
badge: 新
badge: 推荐

tags

文章标签，可选字段，默认为空数组。用于归档页面的标签分类。

YAML
UTF-8 · 2 Lines
tags: ["Astro", "博客", "开发"]
tags: ["教程"]

archive

是否在归档页面显示，可选字段，默认为 true。设置为 false 时，文章不会出现在归档页面。

YAML
UTF-8 · 1 Lines
archive: false

完整示例

YAML
UTF-8 · 12 Lines
---
title: 使用 Astro 构建博客
description: 一篇关于如何使用 Astro 构建个人博客的教程。
date: '2026-01-15'
updatedDate: '2026-02-20'
heroImage: './cover.jpg'
draft: false
abbrlink: build-blog-with-astro
badge: Astro
tags: ["Astro", "博客", "教程"]
archive: true
---

字段速查表

字段必填类型默认值说明
title是string-文章标题
description是string-文章描述
date是Date-发布日期
updatedDate否Date-更新日期
heroImage否Image-封面图片
draft否booleanfalse是否草稿
abbrlink否string-短链接标识
badge否string-徽章标签
tags否string[][]文章标签
archive否booleantrue是否显示在归档页