START HERE / ASTRO + FRONT MATTER CMS
从写第一篇文章开始。
这个页面解释博客的文件结构、文章字段和日常发布流程。你主要需要编辑 Markdown，不需要先学会 Astro。
1. 去哪里写文章
博客文章都放在 src/content/blog/。每个 .md 文件就是一篇文章，文件名会成为 URL 的一部分。
2. Front Matter 是什么
文件开头的 YAML 区域叫 Front Matter，它是文章的结构化信息。Front Matter CMS 会读取这些字段，并提供表单化编辑体验。
---
title: "文章标题"
description: "首页显示的摘要"
pubDate: 2026-09-07
category: "技术"
tags: ["Astro"]
draft: false
---| 字段 | 用途 |
|---|---|
title | 文章标题，必填 |
description | 首页摘要，必填 |
pubDate | 发布日期，必填 |
category | 分类，例如技术、部署、随笔 |
tags | 标签数组，例如 ["Astro", "学习"] |
draft | 设为 true 时不会显示在首页 |
3. 如何预览和发布
在 VS Code 中安装 Front Matter CMS 扩展后，可以从命令面板打开它的 Dashboard，创建或编辑文章。也可以直接编辑 Markdown。
npm run dev # 本地预览
npm run build # 发布前检查
git add .
git commit -m "Add a new post"
git push # Cloudflare 自动部署4. 记住这一条
文章内容在 Markdown，字段规则在 src/content.config.ts，页面模板在 src/pages/。先只改 Markdown，等你熟悉之后再改页面。