Hexo常用命令&markdown语法

本文最后更新于 2025年6月5日 下午

初见Hexo框架并且安装了一些插件,对于命令不太熟悉,以此文档记录汇总常用命令以及markdown语法

部分内容出自Hexo文档,为方便将常用组合命令和插件命令放在了前面,并且删除了$ ,方便使用复制粘贴后直接运行

Hexo

常用组合命令

1.清除缓存文件 (db.json) 和已生成的静态文件 (public),重新生成静态文件 (public),启动本地服务器

1
hexo clean && hexo generate && hexo server

2.重新生成静态文件 (public),再立即部署到服务器

1
hexo deploy --generate

3.清除缓存文件 (db.json) 和已生成的静态文件 (public),重新生成静态文件 (public),再立即部署到服务器(推荐使用)

1
hexo clean && hexo generate && hexo deploy 

区别如下

命令 说明 适用场景
hexo d -g 基于当前已有的缓存生成后 → 部署 未修改主题、插件或配置文件的情况下快速更新文章内容
hexo c && hexo g && hexo d 清理缓存 → 生成 → 部署(完整流程) 修改了主题、插件、配置文件或发现网站显示异常时

如部署时遇到错误,添加 –debug 参数查看详细日志:

1
hexo deploy --debug

插件

1.查看已安装的插件

1
npm ls -dept 0

2.hexo-douban

展示帮助文档

1
hexo douban -h

生成豆瓣页面

1
hexo douban

3.hexo-console-zhihu

在文章同级目录下生成一个 my_post.zhihu.md 文件,方便直接导入知乎文章编辑器,如果不指定文章名,默认处理所有文章。

1
hexo zhihu <可选指定的文章名>

version

1
hexo version

显示版本信息。

new

1
hexo new [layout] <title>

新建一篇文章。 如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。 使用布局 draft 来创建草稿。 如果标题包含空格的话,请使用引号括起来。

选项 描述
-p, --path 文章的路径。 自定义文章的路径。
-r, --replace 如果存在的话,替换当前的文章。
-s, --slug 文章别名。 自定义文章的 URL。

默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。 对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。 你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录:

1
hexo new page --path about/me "About me"

以上命令会创建一个 source/about/me.md 文件,同时 Front Matter 中的 title 为 "About me"

注意! title 是必须指定的! 例如,这不会产生您可能期望的行为:

1
hexo new page --path about/me

此时 Hexo 会创建 source/_posts/about/me.md,同时 me.md 的 Front Matter 中的 title 为 "page"。 这是因为在上述命令中,hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout

clean

1
hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

generate

1
hexo generate

生成静态文件。

选项 描述
-d, --deploy 在生成完成后部署。
-w, --watch 监视文件变动
-b, --bail 生成过程中如果发生任何未处理的异常则抛出异常
-f, --force 强制重新生成
-c, --concurrency 要同时生成的文件的最大数量。 默认无限制

server

1
hexo server

启动服务器。 默认情况下,访问网址为: http://localhost:4000/

选项 描述
-p, --port 重设端口
-s, --static 只使用静态文件
-l, --log 启用日志。 Override logger format.

deploy

1
hexo deploy

部署你的网站。

选项 描述
-g, --generate 在部署前生成

Git Bash

  • 键盘上下键,输入临近的历史命令
  • TAB键,自动补全命令(按一次自动补全,连续按两次,提示所有以输入开头字母的所有命令)
  • ctrl + Insert复制
  • Shift + Insert粘贴
  • clear,清除屏幕里面的所有命令
  • pwd,显示当前目录路径(常用)

我使用的是Fluid主题,记录一些npm的命令

1
npm update --save hexo-theme-fluid

清理 npm 缓存

npm cache clean --force  

先写这些,随用随写


Hexo常用命令&markdown语法
https://mifazhan.top/posts/6fc55794/
作者
米应如是
发布于
2025年2月24日
更新于
2025年6月5日
许可协议