494 字
2 分钟
Fuwari 博客文章开头配置（Frontmatter）详解
在 Fuwari 模板中，每篇文章的开头都有几行被 --- 包裹的代码，这叫 Frontmatter。它决定了文章的标题、日期、分类和封面图。如果配置错误，Cloudflare 构建时可能会报错。
1. 必填参数模板
新建文章时，请直接复制这段代码到 .md 文件最上方：
---title: 这里写文章标题published: 2026-03-20description: 这里写文章简短摘要image: ''tags: [标签1, 标签2]category: '分类名称'draft: false---l:latest2. 关键参数详解
标题与描述 (title & description)
- title: 必填。会显示在网页标签和文章页顶部。
- description: 建议填写。如果不填，列表页会显得很空。
发布日期 (published)
- 格式: 必须严格遵守
YYYY-MM-DD（如 2026-03-20）。 - 注意: 如果填写的日期是“未来”，文章在部署后可能不会立即显示在首页。
封面图 (image)
- 本地图片: 建议放在
src/assets/images/目录下。 引用路径：../../assets/images/文件名.png - 外链图片: 直接填写完整的 URL 地址。
- 留空: 如果不需要封面图，请保持
''。
标签与分类 (tags & category)
- tags: 必须用中括号包裹，例如
[Docker, NAS]。 - category: 建议只写一个分类，用单引号包裹，例如
'折腾记录'。
草稿状态 (draft)
- false: 正常发布（默认）。
- true: 设为草稿，访客在你的博客首页看不到这篇文章。
3. 三大避坑守则
- 冒号后必须有空格：例如
title: 标题是对的，title:标题会导致报错。 - 缩进要统一：YAML 语法对空格非常敏感，不要使用 Tab 键，统一使用空格。
- 特殊字符引号：如果标题里包含冒号
:或引号"，建议将整个标题用单引号包裹起来，例如：title: '教程：如何配置 "Fuwari"'。
4. 快速发布流程
- 本地写好
.md文件并检查 Frontmatter。 - 上传至 GitHub 的
src/content/posts/目录。 - 等待 Cloudflare Pages 自动构建（约 1 分钟）。
- 强制刷新域名（Ctrl + F5）查看效果。
Fuwari 博客文章开头配置（Frontmatter）详解
https://fuwari.vercel.app/posts/frontmatter/