Roc's Blog
目录

写作指南: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 支持

表格、删除线、任务列表都可用:

功能状态
表格
删除线
  • 已完成事项
  • 待办事项