这是一篇示例文章,展示了如何在 AstroPaper 博客中添加新文章。
目录
文章结构说明
Frontmatter 必需字段
每个博客文章必须包含以下 frontmatter 字段:
- title: 文章标题(作为页面的 h1)
- description: 文章描述(用于 SEO 和摘要)
- pubDatetime: 发布日期时间(ISO 8601 格式)
Frontmatter 可选字段
- author: 作者名称(默认使用
SITE.author) - slug: URL 唯一标识符(默认使用文件名)
- featured: 是否在首页精选部分显示(默认:false)
- draft: 是否为草稿(默认:false)
- tags: 文章标签数组(默认:[“others”])
- ogImage: OG 图片路径或 URL
- canonicalURL: 规范 URL
- hideEditPost: 隐藏编辑按钮(默认:false)
- timezone: 时区设置(IANA 格式)
- modDatetime: 修改日期时间(ISO 8601 格式)
内容编写规则
标题使用
- 文章主标题使用 frontmatter 中的
title字段 - 文章内容中的标题从 h2(##)开始
- 建议使用 h2 ~ h6,不要使用 h1
目录添加
要添加目录,在需要的位置添加:
## 目录
代码块
使用三个反引号包裹代码:
const example = "这是代码示例";
console.log(example);
图片引用
使用 assets 目录(推荐)

使用 public 目录

文件位置
- 基础路径:
src/data/blog/ - 可以组织到子目录:
src/data/blog/2025/example.md - 如果不想子目录影响 URL,文件夹名前加下划线:
src/data/blog/_drafts/example.md
总结
遵循以上格式要求,您就可以在 AstroPaper 博客中成功添加新文章了!