本站
内容写作与发布流程
新增博客、项目、知识库和 Lab 内容时的文件位置、frontmatter 规范与本地验证步骤。
本文目录
新增内容只需要创建 Markdown 或 MDX 文件，不需要修改页面路由。下面以博客为例；项目、知识库和 Lab 使用各自的 Schema。
新建博客
在 src/content/blog/ 下创建 .md 文件，文件名会成为 URL slug：
---
title: "文章标题"
description: "一句话摘要，用于列表、SEO description 和 RSS。"
pubDate: "2026-11-08"
updatedDate: "2026-11-08"
tags: ["Astro", "工程实践"]
draft: true
---字段约束见 src/content.config.ts。description 必填；cover、canonicalURL 可选；草稿不会出现在生产构建的列表和 RSS 中（开发模式仍可预览）。
写作约定
- 开头先直接说明文章解决什么问题，避免长段铺垫；
- 技术文章记录验证环境、软件版本和验证日期；
- 命令、配置和代码使用标准代码块；
- 标题层级从
##开始，#由页面标题占用； - 图片必须有 alt 文本；
- 相关文章用站内链接，不依赖外部搜索；
- 不把未验证的步骤写成确定结论。
项目、知识库与 Lab
项目 frontmatter 需要 date、updatedDate、status、stack 等字段；知识库需要 category、updatedDate，可用 parent 和 related 建立层级与交叉引用；Lab 需要 date、updatedDate、status，正文使用 .mdx 以便导入交互组件。
本地验证
pnpm install
pnpm dev # 本地预览，包含草稿
pnpm check # 类型与 Schema 检查
pnpm build # 生产构建 + Pagefind 索引
pnpm preview # 预览 dist发布前至少确认：详情页可访问、列表排序正确、RSS 包含新文章、Sitemap 更新、搜索能命中正文。草稿正式发布时把 draft 改为 false。