博客写作

博客是 Vergil 最主要的内容形式，适合发布长文章、教程、深度思考等内容。

文件位置

博客文章存放在 src/content/blog/ 目录下，使用 Markdown 格式（.md 或 .mdx）。

文章信息头

每篇文章开头需要填写信息头：

---
title: 文章标题
excerpt: 文章摘要（可选）
publishDate: 2026-04-23
updatedDate: 2026-04-25    # 更新日期（可选）
tags:
  - 标签一
  - 标签二
category: 分类名称
series: 专栏名称
draft: false
banner: /images/cover.jpg   # 封面图路径（可选）
---

字段说明

字段	必填	说明
title	是	文章标题
excerpt	否	文章摘要，用于列表页预览。不填则自动取正文前 200 字
publishDate	是	发布日期，格式为 YYYY-MM-DD
updatedDate	否	更新日期，有更新时填写
tags	否	标签列表，可写多个
category	否	文章分类，一篇文章只能有一个分类
series	否	所属专栏，一篇文章只能属于一个专栏
draft	否	草稿状态，true 为草稿，不会发布；false 为正式发布
banner	否	封面图路径，会在文章详情页顶部展示

标签写法

标签在信息头中用列表形式书写：

---
tags:
  - React
  - 前端
  - 教程
---

文章发布后，这些标签会：

• 显示在文章详情页底部
• 点击标签可跳转到标签聚合页，查看同标签的所有文章
• 出现在 /tags 页面，按使用频率排序

分类与专栏

分类

分类用于将文章归入大的主题方向。一篇文章只能有一个分类。

---
category: 技术
---

分类会在 /categories 页面展示，点击分类可查看该分类下的所有文章。

专栏

专栏用于将系列文章串联起来。一篇文章只能属于一个专栏。

---
series: 搭建博客系列
---

属于同一专栏的文章，在详情页底部会自动显示”上一篇 / 下一篇”导航，方便读者连续阅读。

草稿功能

文章写了一半不想发布？将 draft 设为 true：

---
draft: true
---

草稿文章不会出现在博客列表中，但你可以通过直接访问 URL 预览。

封面图

为文章添加封面图，让文章详情页更美观：

---
banner: /images/my-cover.jpg
---

封面图建议尺寸：1200 × 400 像素，比例 3

。

图片可以放在 public/images/ 目录下，或者使用在线图片 URL。