1. 博客概述#

这个博客模板基于Astro框架构建，具有以下特点：

• 快速的页面加载速度
• 现代化的UI设计
• 支持Markdown写作
• 响应式布局，适配各种设备
• 支持文章分类和标签
• 支持文章置顶功能

对于本指南中未提及的内容，您可以在Astro官方文档中找到答案。

2. 文章Front-matter详解#

每篇文章的开头都需要包含Front-matter（前置元数据），它定义了文章的基本信息。以下是一个完整的示例：

1
---
2
title: 我的第一篇博客文章
3
published: 2025-12-15
4
description: 这是我新博客的第一篇文章。
5
image: ./cover.jpg
6
tags: [前端, JavaScript]
7
category: 技术
8
draft: false
9
pinned: true
10
priority: 0
11
licenseName: MIT
12
author: AxyAu
13
sourceLink: https://example.com
14
---

3. 文章文件存放位置#

所有博客文章都应该存放在src/content/posts/目录下。您可以创建子目录来更好地组织文章和相关资源：

1
src/content/posts/
2
├── 技术文章/              # 技术分类的子目录
3
│   ├── 前端开发/          # 前端开发子分类
4
│   │   ├── 第一篇文章.md   # 文章文件
5
│   │   └── cover.jpg      # 文章封面图片
6
│   └── 后端开发.md        # 直接存放在技术文章目录下的文章
7
└── 生活随笔.md            # 直接存放在posts目录下的文章

4. 创建新文章#

要创建新文章，请按照以下步骤操作：

1. 在src/content/posts/目录下创建一个新的Markdown文件（.md）
2. 在文件开头添加Front-matter元数据
3. 在Front-matter之后编写文章内容
4. 如果需要，可以在同一目录下添加封面图片和其他资源

5. 文章格式与样式#

博客支持标准的Markdown语法，包括：

• 标题（#、##、###…）
• 段落和换行
• 粗体（粗体）和斜体（斜体）
• 列表（有序列表和无序列表）
• 链接（链接文本）
• 图片（）
• 代码块（使用 ``` 包裹）
• 表格（如Front-matter属性说明中的表格）
• 引用（使用 > 开头）

1
// JavaScript代码示例
2
function hello() {
3
  console.log('Hello, World!');
4
}

1
# Python代码示例
2
print("Hello, World!")

6. 添加图片#

1
# 使用网络图片
2
image: https://example.com/cover.jpg
3

4
# 使用public目录中的图片
5
image: /images/cover.jpg
6

7
# 使用相对路径图片
8
image: ./cover.jpg

1
![图片描述](./images/pic1.jpg)
2
![网络图片](https://example.com/pic2.jpg)

7. 使用标签和分类#

1
tags: [前端, JavaScript, React]

1
category: 技术

8. 发布文章#

要发布文章，只需将Front-matter中的draft属性设置为false，然后保存文件即可：

1
draft: false

发布后，文章将显示在博客的文章列表中。

9. 设置草稿#

如果您的文章尚未完成，可以将其设置为草稿状态：

1
draft: true

草稿文章不会在博客中显示，只有将draft设置为false后才会发布。

10. 高级功能#

1
pinned: true
2
priority: 0  # 优先级最高

1
author: 用户名

1
licenseName: MIT

11. 常见问题#

12. 总结#

本指南详细介绍了AxyAu博客系统的使用方法，包括：

• 文章Front-matter配置
• 文章文件组织
• Markdown写作技巧
• 图片添加方法
• 标签和分类使用
• 文章发布和草稿管理
• 高级功能

希望本指南能帮助您更好地使用这个博客系统。如果您有任何问题或建议，欢迎提出！