11/2/2026

写第一篇博客

博客模块怎么读文章,以及需要哪些 frontmatter 字段


博客文章放在 content/blog/,一篇文章一个 Markdown 文件。文件名就是文章的 URL 路径段:content/blog/hello.md 对应 /marketing/blog/hello。

一篇文章需要标题、描述与日期,其余字段都有默认值:

字段必填含义
title是文章标题,列表页与正文页都用它
description是一句话描述,用于列表页与 <meta name="description">
date是ISO 时间戳;列表按它倒序排列,最新的在前
published否false 时不进列表、不进 sitemap、不进 llms.txt
locale否en 或 zh;不写时按文件名后缀判断
tags否自由标签,目前只有你自己的模板会用到
image否封面图的绝对地址

两种语言,一个文件名

译文共用文件名、靠后缀区分:hello.md 是英文,hello.zh.md 是中文。URL 不带语言 ——语言按请求协商,同一个地址会显示对应语言的译文;缺译文时回退,而不是 404。

正文

正文是 Markdown,用 src/components/mdx/ 里的组件渲染。标题会生成稳定的锚点 id, 所以 #configuration 这样的链接不会失效。

写完自己的文章后删掉本文件——它只是格式示例,不该原样发布。