这篇文章演示本站支持的常用写法，你可以直接复制本文的源码改成自己的内容。

一、这篇文件的源码在哪

打开 source/_posts/writing-guide.md 就能看到本文的全部源码，对照着看最直观。

二、front-matter 必填项

1
2
3
4
5
6
7
8
9
10
11
---
title: 写作指南：Hexo 与 Butterfly 常用写法
date: 2026-10-11 12:00:00     # 必须写！决定文章 URL，别删
updated: 2026-10-11 12:00:00  # 可选，不写则不显示"更新于"
tags:
  - Hexo
  - 教程
categories:
  - 技术
  - 博客搭建
---

date 一旦确定就不要改，改了这个链接就变了，旧链接全部失效。

时间请统一用 12:00:00（重要）

文章 URL 里的日期来自 date，而 Hexo 生成 URL 时用的是构建机器的本地时区——_config.yml 里的 timezone 配置管不住它。

本站本地构建在 Asia/Shanghai，而 Cloudflare 的构建环境是 UTC，两者相差 8 小时。所以时间是凌晨的文章，两边算出的日期会差一天：

date 取值 本地构建 (UTC+8) Cloudflare 构建 (UTC)
2026-10-11 03:00:00 /2026/10/11/… /2026/10/10/… ❌ 不一致
2026-10-11 12:00:00 /2026/10/11/… /2026/10/11/… ✅ 一致

**结论：写文章时把时间统一成当天的 12:00:00**，这样任何时区构建出来的链接都相同。用 hexo new 生成后手动把时分秒改成 12:00:00 即可。

三、摘要分割线

上面那行 <!-- more --> 就是摘要分隔符。它之前的内容会显示在首页卡片上，之后的内容需要点进文章才能看到。

四、标题与文本

1
2
3
4
5
6
## 二级标题
### 三级标题

**加粗**、*斜体*、~~删除线~~、`行内代码`

[站外链接](https://hexo.io/)

五、代码块

标准 Markdown 写法，自动高亮并带复制按钮：

1
2
3
4
5
function greet(name) {
  // Butterfly 会自动识别语言并高亮
  return `你好，${name}`
}
console.log(greet('世界'))
1
2
3
4
# YAML 同样支持
site:
  title: 尹俊杰de博客
  language: zh-CN

六、提示框

1
2
3
4
5
6
7
{% note info %}
信息提示框
{% endnote %}

{% note warning %}
警告提示框
{% endnote %}

实际效果：

这是 info 提示框。可选类型：info、warning、danger、success、primary、default。

这是 warning 提示框，适合写注意事项。

七、表格

1
2
3
| 命令 | 作用 |
|---|---|
| `hexo new` | 新建文章 |
命令 作用
npx hexo new "标题" 新建文章
npx hexo server 本地预览
git push 发布上线

八、图片

因为已开启 post_asset_folder，每篇文章有独立资源目录 source/_posts/写作指南.../。图片放进去后用：

1
{% asset_img sample.png 这是一张示例图片 %}

实际效果：

九、列表与引用

  • 无序列表项
    • 嵌套项
  • 第二项
  1. 有序列表
  2. 第二项

这是一段引用文字，左侧会有竖线装饰。

十、折叠块

1
2
3
{% hideToggle 点我展开 %}
被折叠起来的内容
{% endhideToggle %}
点我展开看隐藏内容

这里是被折叠的内容，点击标题即可展开或收起。

以上就是常用写法。更多标签语法见 Butterfly 官方文档。