Markdown语法与Hexo命令完全指南

引言

在技术写作和博客创作中，Markdown 以其简洁易读的语法成为了最受欢迎的标记语言之一。配合 Hexo 博客平台，我们可以快速搭建个人博客并高效地发布内容。本文将系统介绍 Markdown 的常用语法以及 Hexo 的核心命令，帮助你从零开始掌握博客写作与发布的完整流程。

无论你是刚接触 Markdown 的新手，还是想要提升 Hexo 使用效率的博客作者，本文都将为你提供实用的参考指南。

目录

• 第一部分：Markdown 常用语法
  • 1.1 标题
  • 1.2 文本格式化
  • 1.3 列表
  • 1.4 链接与图片
  • 1.5 代码块
  • 1.6 表格
  • 1.7 引用块
  • 1.8 其他常用元素
• 第二部分：Hexo 博客平台命令
  • 2.1 安装与初始化
  • 2.2 内容管理
  • 2.3 本地预览
  • 2.4 主题管理
  • 2.5 部署发布
  • 2.6 其他实用命令
• 总结

第一部分：Markdown 常用语法

1.1 标题

Markdown 支持六级标题，使用 # 符号的数量来表示标题级别。

语法说明：

• # 表示一级标题（最大）
• ## 表示二级标题
• ### 表示三级标题
• 以此类推，最多支持六级标题 ######

示例代码：

1
2
3
4
5
6

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

渲染效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

注意事项：

• # 与标题文字之间需要保留一个空格
• 建议在标题前后各空一行，以保证良好的可读性
• 在博客文章中，通常 # 一级标题用于文章标题（由 front-matter 自动生成），正文从 ## 二级标题开始

1.2 文本格式化

Markdown 提供了多种文本格式化方式，用于强调和装饰文字内容。

语法说明与示例：

组合使用示例：

1

这是一个**粗体**和*斜体*的组合，还有~~删除线~~和<u>下划线</u>

渲染效果：
这是一个粗体和斜体的组合，还有删除线和下划线

应用场景：

• 使用粗体强调关键词或重要概念
• 使用斜体表示书名、术语或外来语
• 使用删除线标注已废弃或不再适用的内容
• 在技术文档中，合理使用格式化可以提升阅读体验

1.3 列表

Markdown 支持三种类型的列表：无序列表、有序列表和任务列表。

无序列表

语法说明：
使用 -、+ 或 * 加空格来创建无序列表，三种符号效果相同。

示例代码：

1
2
3
4
5
6

- 第一项
- 第二项
  - 子项 2.1
  - 子项 2.2
    - 孙项 2.2.1
- 第三项

渲染效果：

• 第一项
• 第二项
  • 子项 2.1
  • 子项 2.2
    • 孙项 2.2.1
• 第三项

有序列表

语法说明：
使用数字加 . 加空格来创建有序列表。Markdown 会自动处理编号，即使你全部使用 1. 也能正确渲染。

示例代码：

1
2
3
4

1. 第一步：准备工作
2. 第二步：安装依赖
3. 第三步：配置环境
4. 第四步：启动服务

渲染效果：

1. 第一步：准备工作
2. 第二步：安装依赖
3. 第三步：配置环境
4. 第四步：启动服务

任务列表

语法说明：
任务列表常用于待办事项，使用 - [ ] 表示未完成，- [x] 表示已完成。

示例代码：

1
2
3
4
5

- [x] 完成文章大纲
- [x] 撰写正文内容
- [ ] 添加配图
- [ ] 校对修改
- [ ] 发布文章

渲染效果：

• 完成文章大纲
• 撰写正文内容
• 添加配图
• 校对修改
• 发布文章

应用场景：

• 使用无序列表罗列并列的要点
• 使用有序列表描述步骤或流程
• 使用任务列表跟踪写作进度或项目计划

1.4 链接与图片

链接和图片是博客文章中不可或缺的元素。

内联链接

语法说明：
[链接文字](URL "可选标题")

示例代码：

1
2
3

[访问 Hexo 官网](https://hexo.io/zh-cn/)

[访问 GitHub](https://github.com "GitHub 官网")

渲染效果：
访问 Hexo 官网

访问 GitHub

引用链接

语法说明：
引用链接将 URL 定义在文档的其他位置，使正文更加简洁。

示例代码：

1
2
3
4
5
6

这是一个[引用链接][hexo]的示例。

另一个[文档链接][docs]。

[hexo]: https://hexo.io/zh-cn/ "Hexo 官网"
[docs]: https://hexo.io/zh-cn/docs/

渲染效果：
这是一个[引用链接][hexo]的示例。

另一个[文档链接][docs]。

图片插入

语法说明：
![替代文字](图片URL "可选标题")

示例代码：

1
2
3

![Hexo Logo](https://hexo.io/logo.svg "Hexo 标志")

![本地图片](/images/my-photo.jpg)

渲染效果：

带尺寸的图片（HTML 语法）：

1

<img src="https://hexo.io/logo.svg" alt="Hexo Logo" width="200" height="200">

应用场景：

• 在教程文章中链接到官方文档或参考资料
• 使用图片增强文章的视觉效果
• 引用链接适合长文章，保持正文的整洁性

1.5 代码块

代码块是技术博客的核心元素，用于展示代码示例。

行内代码

语法说明：
使用单个反引号 ` 包裹代码。

示例代码：

1
2
3

使用 `npm install` 命令安装依赖。

函数 `console.log()` 用于输出信息。

渲染效果：
使用 npm install 命令安装依赖。

函数 console.log() 用于输出信息。

多行代码块

语法说明：
使用三个反引号 ``` 包裹代码块，可指定语言实现语法高亮。

示例代码：

1
2
3
4
5
6
7
8

```javascript
function greet(name) {
  console.log(`Hello, ${name}!`);
  return true;
}

greet('World');
```

渲染效果：

1
2
3
4
5
6

function greet(name) {
  console.log(`Hello, ${name}!`);
  return true;
}

greet('World');

常用语言标识符

Python 代码示例：

1
2
3
4
5
6
7
8
9
10
11

```python
def fibonacci(n):
    """计算斐波那契数列"""
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

# 打印前10个斐波那契数
for i in range(10):
    print(f"F({i}) = {fibonacci(i)}")
```

渲染效果：

1
2
3
4
5
6
7
8
9

def fibonacci(n):
    """计算斐波那契数列"""
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

# 打印前10个斐波那契数
for i in range(10):
    print(f"F({i}) = {fibonacci(i)}")

Bash 命令示例：

1
2
3
4
5
6
7
8
9
10

```bash
# 安装 Hexo
npm install -g hexo-cli

# 初始化博客
hexo init my-blog

# 进入项目目录
cd my-blog
```

渲染效果：

1
2
3
4
5
6
7
8

# 安装 Hexo
npm install -g hexo-cli

# 初始化博客
hexo init my-blog

# 进入项目目录
cd my-blog

应用场景：

• 行内代码用于提及命令、函数名或变量
• 多行代码块用于展示完整的代码示例
• 始终指定语言标识符以获得最佳的高亮效果

1.6 表格

表格用于展示结构化数据。

基本表格

语法说明：
使用 | 分隔列，使用 - 分隔表头和内容。

示例代码：

1
2
3
4
5
6

| 命令 | 功能 | 常用参数 |
|------|------|----------|
| hexo new | 新建文章 | `<layout> <title>` |
| hexo generate | 生成静态文件 | `-d`, `--deploy` |
| hexo server | 启动本地服务器 | `-p`, `--port` |
| hexo deploy | 部署到远程 | `-g`, `--generate` |

渲染效果：

对齐方式设置

语法说明：

• :--- 左对齐（默认）
• :---: 居中对齐
• ---: 右对齐

示例代码：

1
2
3
4
5

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容1 | 内容2 | 内容3 |
| 文本A | 文本B | 文本C |
| 数据X | 数据Y | 数据Z |

渲染效果：

复杂表格示例：

1
2
3
4
5
6

| 文件类型 | 扩展名 | 用途 | 是否必需 |
|:---------|:------:|------|:--------:|
| 配置文件 | `_config.yml` | 站点配置 | 是 |
| 主题配置 | `_config.[theme].yml` | 主题配置 | 否 |
| 文章文件 | `.md` | 博客文章 | 是 |
| 页面文件 | `.md` | 独立页面 | 否 |

渲染效果：

应用场景：

• 对比不同工具或技术的特性
• 展示命令参数和说明
• 整理配置项及其含义

1.7 引用块

引用块用于引用他人话语、文档内容或突出显示特定信息。

单层引用

语法说明：
使用 > 符号创建引用块。

示例代码：

1
2
3

> 学而不思则罔，思而不学则殆。
> 
> —— 孔子《论语》

渲染效果：

学而不思则罔，思而不学则殆。

—— 孔子《论语》

嵌套引用

语法说明：
使用多个 > 符号创建嵌套引用。

示例代码：

1
2
3
4
5
6
7

> 这是一级引用
> 
> > 这是二级引用
> > 
> > > 这是三级引用
> > > 
> > > > 这是四级引用

渲染效果：

这是一级引用

这是二级引用

这是三级引用

这是四级引用

引用块内使用其他语法

示例代码：

1
2
3
4
5
6
7
8
9
10

> **提示：** 在开始写作之前，建议先规划好文章结构。
> 
> 推荐的写作流程：
> 1. 确定主题
> 2. 编写大纲
> 3. 填充内容
> 4. 校对修改
> 
> ```javascript
> console.log("引用块内也可以包含代码");

1
2
3
4
5
6
7
8
9
10
11
12

**渲染效果：**
> **提示：** 在开始写作之前，建议先规划好文章结构。
> 
> 推荐的写作流程：
> 1. 确定主题
> 2. 编写大纲
> 3. 填充内容
> 4. 校对修改
> 
> ```javascript
> console.log("引用块内也可以包含代码");

应用场景：

• 引用官方文档或权威资料
• 突出显示重要提示或警告
• 展示对话或评论回复

1.8 其他常用元素

分割线

语法说明：
使用三个或以上的 -、* 或 _ 创建分割线。

示例代码：

1
2
3
4
5

---

***

___

渲染效果：

脚注

语法说明：
hexo-renderer-marked 默认不支持标准 Markdown 脚注语法。如需使用脚注功能，可通过以下方式实现：

方式一：使用 HTML 实现

1
2
3
4
5
6
7

Hexo 是一个快速、简洁且高效的博客框架<sup><a href="#fn1">[1]</a></sup>。

它使用 Markdown（或其他渲染引擎）处理文章，结合各类主题，只需几分钟即可生成静态网站<sup><a href="#fn2">[2]</a></sup>。

---
<small id="fn1">[1] Hexo 官网：https://hexo.io/</small>
<small id="fn2">[2] 静态网站无需数据库，部署简单，加载速度快。</small>

方式二：安装脚注插件

1

npm install hexo-renderer-markdown-it --save

安装 markdown-it-footnote 插件后即可使用标准脚注语法 [^1]。

注意事项：

• 默认渲染器不支持脚注，建议使用 HTML 方式替代
• 如需标准脚注语法，需更换渲染器或安装额外插件

表情符号

语法说明：
使用 Emoji 名称包裹在冒号中来插入表情符号。

示例代码：

1
2
3
4
5
6
7
8
9

今天心情真好！:smile: :thumbsup: :heart:

写作进度：:pencil: 正在撰写... :white_check_mark: 已完成！

常用表情：
- 开心：:smile: :grinning: :joy:
- 点赞：:+1: :thumbsup: :100:
- 警告：:warning: :exclamation: :x:
- 技术：:computer: :keyboard: :rocket:

渲染效果：
今天心情真好！:smile: :thumbsup: :heart:

写作进度：:pencil: 正在撰写… :white_check_mark: 已完成！

常用表情：

• 开心：:smile: :grinning: :joy:
• 点赞：:+1: :thumbsup: :100:
• 警告：:warning: :exclamation: :x:
• 技术：:computer: :keyboard: :rocket:

自动链接

语法说明：
使用 <URL> 格式可直接将 URL 转换为链接。

示例代码：

1
2
3

<https://hexo.io/zh-cn/>

<example@email.com>

渲染效果：
https://hexo.io/zh-cn/

转义字符

语法说明：
使用反斜杠 \ 转义 Markdown 特殊字符。

示例代码：

1
2
3
4
5

\*这不是斜体\*

\# 这不是标题

\[这不是链接\]

渲染效果：
*这不是斜体*

# 这不是标题

[这不是链接]

第二部分：Hexo 博客平台命令

2.1 安装与初始化

安装 Hexo

命令语法：

1

npm install -g hexo-cli

参数说明：

使用场景：
首次搭建 Hexo 博客前需要执行此命令。

注意事项：

• 需要先安装 Node.js（推荐 LTS 版本）
• Windows 用户可能需要以管理员身份运行命令提示符
• 安装完成后可使用 hexo -v 验证安装是否成功

验证安装：

1

hexo -v

输出示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

hexo-cli: 4.3.1
os: win32 10.0.19045
node: 18.17.0
v8: 10.2.154.26-node.25
uv: 1.44.2
zlib: 1.2.13
brotli: 1.0.9
ares: 1.19.1
modules: 108
nghttp2: 1.52.0
napi: 9
llhttp: 6.0.10
openssl: 3.0.10+quic
cldr: 43.1
icu: 73.2
tz: 2023c
unicode: 15.0
ngtcp2: 0.8.1
nghttp3: 0.7.0

初始化博客

命令语法：

1

hexo init <folder>

参数说明：

使用场景：
创建全新的 Hexo 博客项目。

完整流程示例：

1
2
3
4
5
6
7
8
9

# 创建并进入博客目录
mkdir my-blog
cd my-blog

# 初始化博客
hexo init

# 安装依赖
npm install

初始化后的目录结构：

1
2
3
4
5
6
7
8
9

.
├── _config.yml              # 站点配置文件
├── package.json             # 项目依赖信息
├── scaffolds/               # 模板文件夹
├── source/                  # 资源文件夹
│   ├── _drafts/             # 草稿
│   └── _posts/              # 文章
├── themes/                  # 主题文件夹
└── node_modules/            # 依赖包

注意事项：

• 初始化会自动安装默认主题（landscape）
• 若网络较慢，可使用国内镜像加速 npm 安装

2.2 内容管理

新建文章

命令语法：

1

hexo new [layout] <title>

参数说明：

使用场景：
创建新的博客文章。

示例：

1
2
3
4
5
6
7
8

# 创建普通文章
hexo new "我的第一篇文章"

# 使用自定义布局
hexo new photo "旅行相册"

# 创建草稿
hexo new draft "未完成的文章"

生成的文件位置：

• hexo new "标题" → source/_posts/标题.md
• hexo new draft "标题" → source/_drafts/标题.md

Front-matter 模板：
新建文章会自动生成 Front-matter：

1
2
3
4
5
6

---
title: 我的第一篇文章
date: 2026-04-18 10:00:00
tags:
categories:
---

新建页面

命令语法：

1

hexo new page <title>

使用场景：
创建独立页面，如关于页、归档页、友链页等。

示例：

1
2
3
4
5

# 创建关于页
hexo new page about

# 创建友链页
hexo new page links

生成的目录结构：

1
2

source/about/index.md
source/links/index.md

注意事项：

• 页面会生成独立的 URL，如 /about/index.html
• 可在 Front-matter 中设置 type 来使用特定模板

草稿管理

命令语法：

1
2
3
4
5

# 发布草稿（移动到 _posts 目录）
hexo publish <title>

# 预览草稿
hexo server --drafts

使用场景：
管理未完成的文章，成熟后再发布。

示例：

1
2
3
4
5

# 发布草稿
hexo publish "未完成的文章"

# 启动服务器时显示草稿
hexo s --drafts

2.3 本地预览

启动本地服务器

命令语法：

1

hexo server [options]

常用简写：

1

hexo s

参数说明：

使用场景：
在本地预览博客效果，修改后自动刷新。

示例：

1
2
3
4
5
6
7
8
9
10
11

# 默认启动（端口 4000）
hexo server

# 指定端口
hexo server -p 5000

# 显示草稿
hexo server --drafts

# 安全模式启动
hexo server --safe

启动成功输出：

1
2
3

INFO  Validating config
INFO  Start processing
INFO  Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.

实时刷新：
Hexo 默认启用了实时刷新功能，修改文章或配置后保存即可自动更新页面，无需手动刷新浏览器。

注意事项：

• 本地服务器仅用于开发预览，不可用于生产环境
• 若端口被占用，可更换端口或使用 netstat 查看占用进程
• 修改 _config.yml 后需要重启服务器才能生效

2.4 主题管理

安装主题

命令语法：

1
2
3
4
5

# 使用 Git 克隆主题
git clone <主题仓库URL> themes/<主题名称>

# 或使用 npm 安装（部分主题支持）
npm install hexo-theme-<主题名称>

使用场景：
为博客更换或安装新主题。

示例 - 安装 Butterfly 主题：

1
2
3
4
5
6
7
8

# 进入 themes 目录
cd themes

# 克隆主题仓库
git clone https://github.com/jerryc127/hexo-theme-butterfly.git butterfly

# 或使用 npm
npm install hexo-theme-butterfly

示例 - 安装 NexT 主题：

1

git clone https://github.com/next-theme/hexo-theme-next themes/next

切换主题

配置方法：
编辑站点配置文件 _config.yml，修改 theme 字段：

1
2

# _config.yml
theme: butterfly  # 将 landscape 改为 butterfly

注意事项：

• 修改配置后需重新生成静态文件：hexo clean && hexo g
• 不同主题有各自的配置方式，请参考主题文档
• 部分主题需要额外安装依赖插件

主题配置

配置方式：
大多数主题推荐使用主题配置文件进行配置：

1
2
3
4
5
6
7
8
9
10
11
12

# _config.butterfly.yml（主题配置文件）
nav:
  logo: /images/logo.png
  display_title: true
  fixed_navbar: true

menu:
  首页: / || fas fa-home
  归档: /archives/ || fas fa-archive
  标签: /tags/ || fas fa-tags
  分类: /categories/ || fas fa-folder-open
  关于: /about/ || fas fa-heart

注意事项：

• 不要直接修改主题源文件，升级时会被覆盖
• 使用主题配置文件（如 _config.[theme].yml）进行自定义
• 定期更新主题以获取新功能和修复

2.5 部署发布

生成静态文件

命令语法：

1

hexo generate

常用简写：

1

hexo g

参数说明：

使用场景：
将 Markdown 文章转换为静态 HTML 文件。

示例：

1
2
3
4
5
6
7
8

# 生成静态文件
hexo generate

# 生成并部署
hexo generate --deploy

# 生成并监视变动
hexo generate --watch

输出目录：
生成的文件位于 public/ 目录。

部署到远程服务器

命令语法：

1

hexo deploy

常用简写：

1

hexo d

参数说明：

使用场景：
将博客发布到 GitHub Pages、GitLab Pages 或其他服务器。

配置部署信息：
编辑 _config.yml：

1
2
3
4
5

# _config.yml
deploy:
  type: git
  repo: <repository url>
  branch: <branch name>

GitHub Pages 部署示例：

1
2
3
4

deploy:
  type: git
  repo: https://github.com/username/username.github.io.git
  branch: main

完整部署流程：

1
2
3
4
5
6
7
8
9
10

# 安装部署插件
npm install hexo-deployer-git --save

# 一键生成并部署
hexo clean && hexo g -d

# 或分步执行
hexo clean
hexo generate
hexo deploy

注意事项：

• 首次部署需要配置 Git 用户信息
• 确保有远程仓库的推送权限
• 部署后可能需要几分钟才能在网站上看到更新
• 建议使用 hexo clean 清理缓存后再部署

2.6 其他实用命令

清理缓存

命令语法：

1

hexo clean

使用场景：
清除生成的静态文件和缓存，解决显示异常问题。

何时使用：

• 修改了主题配置但效果未生效
• 更换主题后
• 文章显示异常
• 部署前确保内容最新

输出示例：

1
2

INFO  Deleted database.
INFO  Deleted public folder.

插件管理

安装插件：

1

npm install <plugin-name> --save

常用插件：

卸载插件：

1

npm uninstall <plugin-name> --save

版本信息查看

命令语法：

1

hexo version

常用简写：

1

hexo -v

使用场景：
查看 Hexo 及相关依赖的版本信息，排查兼容性问题。

完整命令速查表

常用命令组合

1
2
3
4
5
6
7
8
9
10

# 开发工作流
hexo clean && hexo s           # 清理并启动预览

# 发布工作流
hexo clean && hexo g -d        # 清理、生成并部署

# 新建并发布文章
hexo new "文章标题"            # 创建文章
# ... 编辑文章 ...
hexo clean && hexo g -d        # 部署

总结

通过本文的学习，你已经掌握了：

Markdown 语法部分：

• 六级标题的使用方法
• 粗体、斜体、删除线等文本格式化
• 有序列表、无序列表和任务列表
• 链接与图片的插入方式
• 行内代码和多行代码块的使用
• 表格创建与对齐设置
• 单层引用和嵌套引用
• 分割线、表情符号等实用元素
• 脚注的替代实现方式（HTML 或插件）

Hexo 命令部分：

• 博客的安装与初始化流程
• 文章、页面、草稿的创建与管理
• 本地服务器的启动与配置
• 主题的安装、切换与配置
• 静态文件生成与远程部署
• 缓存清理、插件管理等实用命令

最佳实践建议：

1. 写作前先规划：使用任务列表跟踪写作进度
2. 善用代码高亮：技术文章务必指定语言标识符
3. 定期清理缓存：遇到问题先尝试 hexo clean
4. 本地充分预览：部署前使用 hexo s 检查效果
5. 备份重要配置：定期备份 _config.yml 和主题配置

掌握了这些语法和命令，你就可以高效地使用 Markdown 撰写技术文章，并通过 Hexo 快速发布到个人博客。祝你写作愉快！

参考资料：

• Markdown 官方规范
• Hexo 官方文档
• GitHub Flavored Markdown
• hexo-renderer-marked