# 欢迎使用AI Blog
恭喜!你已经成功安装了AI Blog系统。这是一个将Markdown转换为静态HTML页面的个人博客系统。
# 快速开始
# 1. 创建文章
在 content/posts 目录下创建一个新的Markdown文件,例如 my-first-post.md。文件名将用作URL slug。
# 2. 添加Front Matter
每个Markdown文件都需要YAML front matter,用于设置文章元数据:
---
title: "文章标题"
date: 2026-06-02
author: "作者名"
tags: ["标签1", "标签2"]
categories: ["分类"]
description: "文章描述"
image: "文章封面图路径(可选)"
---
# 3. 编写内容
使用标准Markdown语法编写内容。支持以下特性:
- 粗体、斜体、
删除线 - 链接
- 图片:
 - 代码块(支持语法高亮)
- 表格
- 列表(有序和无序)
# 图片处理
系统会自动处理图片:
- 优化:压缩图片,减少文件大小
- 响应式:生成多种尺寸,适配不同设备
- 懒加载:提升页面加载速度
# 本地图片
将图片放在 content/assets/images 目录下,然后在Markdown中引用:

# 外部图片
也可以使用外部图片URL:

# 代码高亮
系统支持代码语法高亮:
function hello() {
console.log("Hello, AI Blog!");
}
def hello():
print("Hello, AI Blog!")
# 表格
| 功能 | 状态 | 说明 |
|---|---|---|
| Markdown转HTML | ✅ | 核心功能 |
| 图片优化 | ✅ | 自动压缩和响应式 |
| 代码高亮 | ✅ | 支持多种语言 |
| 暗色模式 | ✅ | 自动切换 |
| RSS生成 | ✅ | 可选功能 |
# 下一步
- 修改
config/default.yml配置文件 - 创建更多文章
- 自定义主题样式
- 部署到GitHub Pages
# 部署到GitHub Pages
- 将代码推送到GitHub仓库
- 在仓库设置中启用GitHub Pages
- 选择部署分支(通常是
main或gh-pages) - 等待构建完成,访问你的博客!
# 获取帮助
如有问题,请查看文档或提交Issue。
本文由AI Blog系统自动生成。