Hexo-Redefine 博客写作与排版超级指南

欢迎来到你的个人博客！这篇指南是由你的 AI 助手为你特别定制的。它既是一篇博文，也是一个活生生的排版样板。

你可以在本地用编辑器打开 source/_posts/Hexo-Redefine使用指南.md，对照着这篇网页的呈现效果，就能快速学会如何写出精美的博客文章！

---

一、 文章配置 (Front-matter)

每一篇新建的文章顶部，都会有一段被 --- 包裹的 YAML 配置区，用于定义文章的元数据。以下是常用参数说明：

---
title: 文章标题
date: 2026-07-05 10:30:00  # 自动生成，不用改
tags: [标签1, 标签2]       # 文章标签，会显示在侧边栏和标签页
categories: [分类1, 分类2]  # 文章分类
cover: https://example.com/image.jpg  # 文章封面图链接（非常推荐加上，会让首页很好看）
sticky: 10                 # 置顶权重，数字越大越靠前（不置顶则删掉这一行）
comment: true              # 是否开启评论，默认为 true
---

---

二、 基础 Markdown 写作

这里只列出最常用的几种格式：

1. 标题层级

直接用 # 符号：
## 二级标题（文章大章节，不推荐用一级标题 #，因为文章名本身就是一级标题）
### 三级标题（小节）

2. 代码高亮

用三个反引号包裹：

console.log("Hello, Jeffery's Blog!");

3. 引用框

使用 > 符号：

凡是过往，皆为序章。

---

三、 Redefine 主题独有的“黑魔法”排版

Redefine 主题内置了很多非常漂亮的 Tag 插件。你可以在你的 Markdown 里直接输入这些代码，网页会自动渲染出精美的样式：

1. 彩型提示框 (Note)

当你需要特别强调某些内容时，可以使用提示框。支持多种颜色风格：

信息提示框 (Info)

提示：这是一个信息提示框，常用于补充背景知识。

警告提示框 (Warning)

警告：这是一个警告提示框，常用于提醒注意某些坑。

危险提示框 (Danger)

危险：这是一个严重警告提示框，用于提示高危操作！

源码写法：

{% raw %}{% note info %}{% endraw %}
**提示**：这是一个信息提示框，常用于补充背景知识。
{% raw %}{% endnote %}{% endraw %}

2. 点击折叠面板 (Fold)

当你有一大段代码或次要内容想隐藏，让读者点击后才展开时，可以使用折叠卡片：

def hello_world():
    print("你成功展开了折叠卡片！")
    return True

源码写法：

{% raw %}{% folding 点击展开查看隐藏代码 %}{% endraw %}
这里写你想隐藏的内容...
{% raw %}{% endfolding %}{% endraw %}

3. 多选项卡切换 (Tabs)

如果你需要在同一个区域展示不同的内容（比如 Windows 和 Mac 的安装步骤），可以使用 Tabs 切换：

Windows 安装步骤Mac 安装步骤

1. 下载 Windows 版安装包。
2. 双击 .exe 文件并按照提示安装。

源码写法：

{% raw %}{% tabs tab-id %}{% endraw %}
<!-- tab Windows 安装步骤 -->
1. 下载 Windows 版安装包。
<!-- tab Mac 安装步骤 -->
2. 下载 Mac 版 `.dmg` 文件。
{% raw %}{% endtabs %}{% endraw %}

4. 精美按钮 (Button)

你可以插入精美的自定义跳转按钮，支持自定义大小、颜色 and 居中方式：

center large

源码写法：

{% raw %}{% btn center large::网址::按钮文字 %}{% endraw %}

---

四、 极简的一键发布流程

在 D 盘的 my-blog 文件夹中写完文章并保存后，你只需要在命令行里依次运行以下三行命令，你的博客就会全自动编译并更新到你的域名上：

git add .
git commit -m "新增文章：我的第一篇博客"
git push

快去你的域名看看效果吧！