Frontmatter

Frontmatter 是置于文档开头的 YAML/TOML/JSON 元数据块，以 --- 分隔，常用于静态站点生成器。

用途

在 Markdown 等正文前附加结构化元数据，便于站点生成与内容管理。

机制

文档以 --- 开头，后接 YAML（或 TOML/JSON）元数据，再以 --- 结束，之后为正文。解析器分离 frontmatter 与正文。Jekyll/Hugo/Astro 等广泛使用。

用例

Astro/Hugo/Jekyll 文章元数据
Markdown 博客文章 frontmatter
文档站点配置
CMS 内容管理

示例

输入

---
title: Hello
---
# Body

输出

meta {title:"Hello"} + body

YAML frontmatter

常见错误

A frontmatter syntax error breaks parsing: Check it with a validator for the corresponding format

相关词条

YAML（YAML 不是标记语言）是面向配置的数据序列化格式，使用缩进表示层级，支持注释与引用，比 JSON 更适合人工编辑。

TOML（Tom 的明显、最小化语言）是面向配置的格式，用表与键值对表示数据，语义明确且无隐式类型推断。

JSON（JavaScript 对象表示法）是轻量级数据交换格式，基于 JavaScript 对象字面量，使用键值对与数组结构。

YAML Frontmatter

YAML frontmatter 是 Markdown 文件顶部的 --- 分隔 YAML 块，存储文档元数据（标题、日期、标签）。

参考链接