My Blog - 博客写作指南

快速开始

1
2
3
4
5
6
7
8
9
10
cd ~/blog

# 1. 创建新文章
hexo new "文章标题"

# 2. 编辑文章（Markdown 格式）
vim source/_posts/文章标题.md

# 3. 生成并部署
hexo clean && hexo g

文章写作指南

1. 文章 Front-matter 配置

1
2
3
4
5
6
7
8
9
10
11
---
title: 文章标题
tags: [标签1, 标签2]
categories: 分类
cover: /img/cover.jpg        # 文章封面图（相对路径或URL）
top_img: /img/banner.jpg     # 顶部大图
abstract: 文章摘要            # 首页显示的摘要
toc: true                    # 显示目录
comments: true               # 开启评论
date: 2026-07-15 09:00:00    # 日期时间
---

2. 参数说明

参数 必填 说明
title ✅ 文章标题
tags ❌ 标签，数组形式
categories ❌ 分类
cover ❌ 封面图（列表页显示）
top_img ❌ 顶部大图
toc ❌ 是否显示目录（true/false）
comments ❌ 是否开启评论（true/false）

3. 图片使用

本地图片：

  1. 把图片放到 ~/blog/source/img/ 目录
  2. 在文章中引用：
1
![图片描述](/img/图片文件名.jpg)

网络图片：

1
![风景图](https://example.com/image.jpg)

4. Markdown 语法示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 一级标题
## 二级标题

**加粗文本**

*斜体文本*

[链接文字](https://example.com)

![图片](https://example.com/image.jpg)

- 列表项 1
- 列表项 2

> 引用块

```python
# 代码块
def hello():
    print("Hello!")
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

### 5. 更多布局

**引用 note 提示框**（Butterfly 主题支持）：

```markdown
<!-- note info -->
::: info
这是提示信息
:::

<!-- note warning -->
::: warning
这是警告
:::

<!-- note danger -->
::: danger
这是危险提示
:::

相册布局：

1
2
3
4
<div class="gallery">
  <img src="/img/photo1.jpg">
  <img src="/img/photo2.jpg">
</div>

常用命令

命令 说明
hexo new "标题" 创建新文章
hexo g 生成静态文件
hexo clean 清理缓存
hexo s 本地预览（localhost:4000）
hexo d 部署（已配置 nginx，无需使用）

目录结构

1
2
3
4
5
6
7
8
9
~/blog/
├── source/
│   ├── _posts/          # 文章目录
│   │   └── first-post.md
│   └── img/             # 图片目录
├── public/              # 生成的静态文件
├── _config.yml          # Hexo 配置
├── _config.butterfly.yml # 主题配置
└── README.md            # 本指南

注意事项

  1. 文章文件名建议使用英文或拼音，避免特殊字符
  2. 修改配置后记得 hexo clean && hexo g
  3. 图片建议使用图床（Unsplash、SM.MS 等）或本地存储