写作指南:frontmatter 与可用组件
1 min read文档
Frontmatter 字段
每篇文章顶部必须有 YAML frontmatter:
---
title: "标题(必填)"
date: "2026-09-17" # 必填,ISO 日期
updated: "2026-09-18" # 可选,更新时间
excerpt: "摘要" # 可选,用于 SEO description 和列表页
categories: ["分类"]
tags: ["tag1", "tag2"]
cover: "/uploads/xxx.webp" # 可选,OG 图
draft: true # 草稿,只在 dev 环境显示
id: 9999 # 可选;迁移文章=WP ID,新文章不填则用文件名
---URL 规则:/archives/{id}.html;无 id 时用文件名:content/posts/hello.mdx → /archives/hello.html。
MDX 组件
Callout
<Callout type="info">提示信息</Callout>
<Callout type="warning">警告信息</Callout>
<Callout type="tip">小技巧</Callout>这是一个 info 类型的 Callout。
GFM 支持
表格、删除线、任务列表都可用:
| 功能 | 状态 |
|---|---|
| 表格 | ✅ |
| ✅ |
- 已完成事项
- 待办事项