Markdown 写作指南

StepMan Lv1

这篇文章将展示 Hexo 博客中常用的 Markdown 语法,帮助你快速上手博客写作。

1. 标题 Heading

Markdown 支持六个级别的标题,使用 # 符号表示。

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

渲染效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 文本格式化

加粗、斜体、删除线

1
2
3
4
**这是加粗文本**
*这是斜体文本*
~~这是删除线文本~~
***同时加粗和斜体***

渲染效果:

这是加粗文本
这是斜体文本
这是删除线文本
同时加粗和斜体


3. 列表 List

无序列表

1
2
3
4
5
- 第一项
- 第二项
- 嵌套项 1
- 嵌套项 2
- 第三项

渲染效果:

  • 第一项
  • 第二项
    • 嵌套项 1
    • 嵌套项 2
  • 第三项

有序列表

1
2
3
1. 第一步
2. 第二步
3. 第三步

渲染效果:

  1. 第一步
  2. 第二步
  3. 第三步

任务列表

1
2
3
- [x] 已完成的任务
- [ ] 待完成的任务
- [ ] 另一个待办

渲染效果:

  • 已完成的任务
  • 待完成的任务
  • 另一个待办

4. 链接与图片

链接

1
2
[链接文字](https://example.com)
[本地链接](/2026/03/hello-world/)

渲染效果:

链接文字
本地链接

图片

1
![图片描述](图片URL)

注意:如果需要插入本地图片,可以将图片放入 source/images/ 目录,然后使用 /images/图片名.png 引用。


5. 引用 Blockquote

1
2
3
4
> 这是一段引用内容
> 可以换行继续写
>
> 支持多段引用

渲染效果:

这是一段引用内容
可以换行继续写

支持多段引用

引用嵌套

1
2
3
> 外层引用
> > 内层引用
> > > 更深的嵌套

渲染效果:

外层引用

内层引用

更深的嵌套


6. 代码 Code

行内代码

1
使用 `printf()` 函数输出 hello world

渲染效果:

使用 printf() 函数输出 hello world

代码块

1
2
3
4
5
```python
def hello_world():
print("Hello, World!")
return True
​```

渲染效果:

1
2
3
def hello_world():
print("Hello, World!")
return True

支持的语言

1
2
3
# 这是一个 YAML 代码块
name: hexo
version: 8.0.0
1
2
// JavaScript
const hexo = require('hexo');
1
2
# Bash 命令
hexo new post "我的文章"

7. 表格 Table

1
2
3
4
| 左对齐 | 居中 | 右对齐 |
|:------|:----:|-------:|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

渲染效果:

左对齐 居中 右对齐
内容1 内容2 内容3
内容4 内容5 内容6

8. 分割线 Horizontal Rule

1
2
3
4
---
***

___

渲染效果:





9. 目录 Table of Contents

使用 [TOC] 自动生成目录:

1
[TOC]

[TOC]

注意:Redefine 主题支持在文章中自动显示目录。


10. 脚注 Footnote

1
2
3
这里有一个脚注[^1]。

[^1]: 这是脚注的内容解释。

渲染效果:

这里有一个脚注^1


11. 特殊符号转义

如果需要显示 Markdown 特殊符号,可以使用反斜杠 \ 转义:

1
2
3
\* 这不是一个列表
\# 这不是一个标题
\` 这不是代码

渲染效果:

* 这不是一个列表
# 这不是一个标题
` 这不是代码


总结

以上是 Hexo 博客中最常用的 Markdown 语法。掌握这些写法,你就可以开始写博客了!

“写作是一种思考的方式” —— 祝你的博客之旅愉快!

  • 标题: Markdown 写作指南
  • 作者: StepMan
  • 创建于 : 2026-03-18 20:10:00
  • 更新于 : 2026-03-18 20:37:07
  • 链接: http://retoollivableshredding6.top/2026/03/markdown-guide/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论