博客功能使用说明

功能特性

✅ 搜索功能 - 根据标题和描述搜索博客 ✅ 分类筛选 - 按分类浏览博客文章 ✅ 标签筛选 - 按标签过滤内容 ✅ 阅读时间 - 自动计算文章阅读时间 ✅ 封面图片 - 支持文章封面和内容图片 ✅ 响应式设计 - 完美适配移动端和桌面端

如何添加新博客文章

1. 在 content/posts/ 目录下创建新的 .md 文件
2. 文件名将作为 URL slug，例如 my-first-post.md 对应 /blog/my-first-post
3. 每个博客文章需要包含 frontmatter 元数据

博客文章格式

---
title: "文章标题"
date: "2026-03-19"
description: "文章简介，会显示在列表页"
category: "分类名称"
tags: ["tag1", "tag2", "tag3"]
author: "作者名"
image: "/path/to/cover-image.png"
---

# 文章内容

这里是正文...

## 添加图片

![图片描述](/path/to/image.png)

## 添加代码

\`\`\`python
def hello():
    print("Hello World")
\`\`\`

字段说明

• title (必填): 文章标题
• date (必填): 发布日期，格式 YYYY-MM-DD
• description (推荐): 文章简介，显示在列表页
• category (可选): 文章分类，用于筛选
• tags (可选): 标签数组，用于筛选和展示
• author (可选): 作者名称
• image (可选): 封面图片路径，相对于 public 目录

图片使用

1. 将图片放在 public/ 目录下（例如 public/blog/my-image.png）
2. 在 markdown 中使用相对路径引用：![描述](/blog/my-image.png)
3. 封面图片在 frontmatter 中指定：image: "/blog/cover.png"

示例

参考 content/posts/welcome.md 文件查看完整示例。

访问博客

• 博客列表页：/blog
• 博客详情页：/blog/[文章slug]

提示

• 阅读时间会根据文章字数自动计算（中文按字符，英文按单词）
• 支持 Markdown 所有标准语法
• 图片会自动优化和响应式处理
• 搜索功能支持标题和描述的模糊匹配