这篇是给自己的备忘:常用命令、文章开头要写什么、图片怎么放。

一、常用命令

目的 命令
新建文章 npx hexo new "文章标题"
新建独立页面 npx hexo new page "页面名"
本地预览(带热重载) npx hexo server
生成静态文件到 public/ npx hexo generate
清空缓存重新生成 npx hexo clean && npx hexo generate

预览地址是 http://localhost:4000。

二、文章开头(front-matter)

1
2
3
4
5
6
7
8
9
10
---
title: 文章标题
date: 2026-09-30 22:45:00
tags:
- 标签一
- 标签二
categories:
- 分类名
description: 一句话摘要,会显示在首页列表和搜索结果里
---
  • tags 和 categories 随便写,Hexo 会自动生成对应页面
  • description 建议写,首页摘要优先用它
  • 文件名用英文(如 my-first-post.md),标题用中文。这样网址是英文的,干净且不会出现一串 %E4%BD%A0%E5%A5%BD 这种编码

三、放图片(重要)

本站开启了 post_asset_folder:新建文章时会自动生成同名文件夹。

1
2
3
4
source/_posts/
├── my-first-post.md
└── my-first-post/
└── screenshot.png

文章里这么引用:

1
![截图说明](screenshot.png)

用的是相对路径,不是 https://你的域名/...。 这是关键——将来换域名时,所有图片都不用改。请不要在文章里粘贴带完整域名的图片地址。

四、代码块

1
2
3
```python
print("hello")
```

五、几条纪律(为了将来换域名不痛苦)

  1. 文章里永远不要写死完整网址,站内链接写 /archives/ 这种相对路径
  2. 图片用相对路径,或者放 source/img/ 下用 /img/xxx.png 引用
  3. 需要改站名、简介、作者,统一去 _config.yml 改
  4. 需要改主题外观、导航、评论,统一去 _config.butterfly.yml 改