本站文章上传规范

1. 文章放在哪里#

所有正式文章放在：

1
src/content/posts/

推荐两种组织方式：

1
src/content/posts/my-note.md
2
src/content/posts/my-note/index.md
3
src/content/posts/my-note/cover.jpg

如果文章需要多张配图，建议使用第二种「文章文件夹」方式，把图片和 index.md 放在一起，后期移动或备份更方便。

2. Frontmatter 必填与常用字段#

每篇 Markdown/MDX 文件顶部都要有 frontmatter：

1
---
2
title: 文章标题
3
published: 2026-06-19
4
description: 一句话摘要，会显示在列表与 SEO 信息里。
5
tags: [博客, 写作]
6
category: 博客维护
7
draft: false
8
image: ./cover.jpg
9
---

常用字段说明：

3. 图片与附件规范#

• 文章专属图片：优先放在文章同级目录，用 ./image-name.jpg 引用。
• 公共图片：放到 public/assets/images/，用 /assets/images/xxx.jpg 引用。
• 文件名建议只用英文、数字、短横线：my-cover-01.jpg。
• 避免空格、中文标点和过长文件名，减少部署后路径问题。
• 封面图建议横图，体积尽量压缩到合理大小。

4. 草稿与发布流程#

写作中：

1
draft: true

确认发布时改为：

1
draft: false

或删除 draft 字段。发布前至少检查：

1. 标题、日期、分类和标签是否正确。
2. 图片路径是否能在本地预览中打开。
3. Markdown 表格、代码块、引用块是否闭合。
4. 如果是 MDX，JSX 标签必须闭合，属性要合法。
5. 本地执行构建，确认没有 frontmatter 或资源路径报错。

5. 自动部署说明#

本站已经接入 GitHub 自动部署。正常流程是：

1
git add .
2
git commit -m "添加文章：文章标题"
3
git push origin master

推送到主分支后，GitHub Actions 会自动构建并同步到服务器。若线上没有马上更新，先等待 Actions 完成，再刷新页面或清理浏览器缓存。