常用命令

Quick Start

Create a new post

1
$ hexo new "My New Post"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

Write Drafts

1
hexo n draft draft1

在source\目录下创建_drafts目录，并生成一个draft1.md文件

当你编辑完草稿后，可以把文章推送到_posts目录下

1
$ hexo publish <file_name>

或

1
hexo --draft

Deploy In Github

1
2
3
4
5
6
7
# 清理旧文件
hexo clean
# 生成新文件
hexo g
# 部署到 GitHub Pages
hexo d
hexo server

引用图片

1
![alt](path [title])

path是必选的，表示图片的路径，可使用绝对或相对路径。

alt是可选的，是图片无法加载时的替代描述文本。

title是可选的，是图片的标题

将所有文章的图片放到source/images 文件夹中，然后使用markdown语句引用图片

或

为每一个文章创建一个资源文件夹，将图片保存其中，具体步骤如下：

  • 在博客根目录打开_config.yml文件做如下修改： yaml post_asset_folder: true
  • 然后使用hexo n text命令后创建一个使用post布局名为text的文章，你将发现hexo在\source\_post文件夹下创建了一个\text文件夹以及同名的.md文件：
  • 最后就可以打开text.md文件进行编辑了，你可以把要引用的图片放到同名文件夹下，然后使用相对路径进行引用。注意：请不要自作聪明将text.md文件移动到同名文件夹下，经本人尝试，发现这样会导致图片无法正常引用

hexo插入图片的原生语法

使用 Hexo 的 asset_img 标签

1
{% asset_img 文件名.后缀 图片描述 %}
  • 需要将图片放在 source/images/ 目录下（或 _config.yml 中 post_asset_folder: true 时与文章同名的文件夹中）
  • 文件名需要包含后缀（如 .jpg, .png 等）

使用 HTML 的 标签

1
<img src="图片路径" alt="图片描述" width="宽度" height="高度">

插入视频

1
2
3
<video width="480" height="320" controls>
<source src=video_path>
</video>
  • video_path是视频的存储路径（含双引号），你可以把视频放在文章的同名资源文件夹下，然后用相对路径方式引用。
  • width和height是视频区块的宽度和高度，可自定义。

引用和代码区块

1
2
3
{% blockquote [author[, source]] [link] [source_link_title] %}
content...
{% endblockquote %}

例如：

Quick Start

还有一种简单的引用语法：

1
2
3
4
5
> 这也是引用
>
> 引用1
>
> 饮用2

这也是引用

引用1

饮用2

代码用Hexo的太麻烦了

用markdown原来的```得了

Mermaid画流程图

语法

butterfly主题的标签外挂语法

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
{% note simple %}
默认 提示块标签
{% endnote %}

{% note default simple %}
default 提示块标签
{% endnote %}

{% note primary simple %}
primary 提示块标签
{% endnote %}

{% note success simple %}
success 提示块标签
{% endnote %}

{% note info simple %}
info 提示块标签
{% endnote %}

{% note warning simple %}
warning 提示块标签
{% endnote %}

{% note danger simple %}
danger 提示块标签
{% endnote %}


{% note [class] [no-icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}

butterfly主题下的tag-hide

如果你想把一些文字、内容隐藏起来，并提供按钮让用户点击显示。可以使用这个标签外挂。

inline 在文本里面添加按钮隐藏内容，只限文字

( content 不能包含英文逗号，可用 &sbquo;)

1
{% hideInline content,display,bg,color %}

参数 解释 content 文本内容 display 【可选】按钮显示的文字 bg 【可选】按钮的背景颜色 color 【可选】按钮文字的颜色

1
2
3
哪个英文字母最酷？ {% hideInline 因为西装裤(C装酷),查看答案,#FF7242,#fff %}

门里站着一个人? {% hideInline ErgouTree %}

哪个英文字母最酷？ 因为西装裤(C装酷)

门里站着一个人? ErgouTree

butterfly主题下的tabs

1
2
3
4
5
6
7
8
9
{% tabs Unique name, [index] %}

<!-- tab [Tab caption] [@icon] -->

Any content (support inline tags too).

<!-- endtab -->

{% endtabs %}
image-20250415170911049
image-20250415170911049 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{% tabs test1 %}

<!-- tab -->

**This is Tab 1.**

<!-- endtab -->

<!-- tab -->

**This is Tab 2.**

<!-- endtab -->

<!-- tab -->

**This is Tab 3.**

<!-- endtab -->

{% endtabs %}

This is Tab 1.

This is Tab 2.

This is Tab 3.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% tabs test4 %}

<!-- tab 第一个Tab -->

**tab 名字为第一个 Tab**

<!-- endtab -->

<!-- tab @fab fa-apple-pay -->

**只有图标 没有 Tab 名字**

<!-- endtab -->

<!-- tab 炸弹@fas fa-bomb -->

**名字+icon**

<!-- endtab -->

{% endtabs %}

tab 名字为第一个 Tab

只有图标 没有 Tab 名字

名字+icon

文章写完之后

编写好markdown文章后接下来就需要渲染、生成静态文件，启动本地端口查看效果了。

生成/删除静态文件

生成静态文件命令：hexo generate或 hexo g 删除静态文件命令：hexo clean

正常情况下，每次启动本地端口前只需更新静态文件即可。Hexo引入了差分机制，如果 public 目录存在，那么 hexo g 只会重新生成改动的文件。

如果发生了一些错误，可以先删除静态文件，然后再重新生成。hexo g命令还提供了一个参数-f提供以类似效果。这样做的缺点就是当文章数变多以后渲染时间会更久一些。

启动本地端口

命令：hexo server或 hexo s