GitHub Pages 是 GitHub 提供的静态网站托管服务，可以直接从 GitHub 仓库托管网站。

部署方式

方式一：手动部署

使用 hexo-deployer-git 插件：

1
2

npm install hexo-deployer-git --save
hexo clean && hexo g && hexo d

方式二：GitHub Actions 自动部署（推荐）

创建 .github/workflows/deploy.yml 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

name: Deploy Hexo to GitHub Pages

on:
  push:
    branches:
      - main

permissions:
  contents: write
  pages: write
  id-token: write

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: true

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '18'

      - name: Install dependencies
        run: npm install

      - name: Generate static files
        run: npx hexo generate

      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./public

配置步骤

1. 在 GitHub 创建仓库 username.github.io
2. 推送代码到仓库
3. 进入仓库 Settings -> Pages
4. 选择 gh-pages 分支作为源
5. 等待部署完成

自定义域名

如果需要绑定自定义域名：

1. 在仓库根目录创建 CNAME 文件，内容为域名
2. 配置 DNS 解析
3. 在 GitHub Pages 设置中填写自定义域名

常见问题

部署失败

• 检查 Node.js 版本
• 查看 GitHub Actions 日志
• 确认依赖安装成功

页面无法访问

• 确认分支设置正确
• 检查 CNAME 配置
• 等待 DNS 生效

总结

GitHub Pages 是免费且可靠的静态网站托管服务，配合 GitHub Actions 可以实现自动化部署，非常适合个人博客和项目文档。

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。

基本语法

标题

1
2
3

# 一级标题
## 二级标题
### 三级标题

粗体和斜体

1
2
3

**粗体文本**
*斜体文本*
***粗斜体文本***

列表

无序列表：

1
2
3

- 项目1
- 项目2
- 项目3

有序列表：

1
2
3

1. 第一项
2. 第二项
3. 第三项

链接和图片

1
2

[链接文字](https://example.com)
![图片描述](https://example.com/image.jpg)

代码

行内代码：`code`

代码块：

1
2
3

function hello() {
  console.log("Hello, World!");
}

引用

1

> 这是一段引用文字

表格

1
2
3

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 内容1 | 内容2 | 内容3 |

高级用法

任务列表

1
2

- [x] 已完成任务
- [ ] 未完成任务

脚注

1
2
3

这里有一个脚注[^1]

[^1]: 这是脚注内容

总结

Markdown 简单易学，是写作和技术文档的首选格式。掌握这些基本语法，就能满足大部分写作需求。

欢迎来到我的博客！这是使用 Hexo + Anzhiyu 主题搭建的个人博客。

为什么选择 Hexo？

Hexo 是一个快速、简洁且高效的博客框架，具有以下优点：

• 速度快：基于 Node.js，生成速度极快
• Markdown 支持：使用 Markdown 写作，简单高效
• 丰富的主题：拥有大量精美的主题可供选择
• 易于部署：支持多种部署方式

为什么选择 Anzhiyu 主题？

Anzhiyu 是一个功能丰富、设计精美的 Hexo 主题，主要特点包括：

• 响应式设计，支持移动端
• 内置深色模式
• 支持多种评论系统
• 丰富的自定义选项
• 支持音乐播放器

博客搭建过程

1. 安装 Hexo

1
2
3
4

npm install hexo-cli -g
hexo init blog
cd blog
npm install

2. 安装 Anzhiyu 主题

1
2

cd themes
git clone https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git

3. 配置主题

编辑 _config.anzhiyu.yml 文件进行个性化配置。

4. 部署到 GitHub Pages

使用 GitHub Actions 实现自动部署。

后续计划

• 完善博客内容
• 配置评论系统
• 添加更多功能

结语

博客搭建完成，接下来就是持续输出优质内容了。希望这个博客能够帮助到更多人，也欢迎交流讨论！