你正在看的这篇文章，就是用 Markdown 写出来的 🎉

Markdown 是一种轻量级标记语言，用最简单的几个符号就能控制文字的格式——标题、加粗、列表、表格、代码高亮……它已经成为程序员、作家、博主的标配写作方式。GitHub、知乎、语雀、Notion、微信公众号编辑器（配合工具）全都支持。

这篇文章会带你把 Markdown 的全部常用语法过一遍。你可以对照本文源文件（source/_posts/markdown-tutorial.md）边看边练。

一、标题

用 # 号开头，几个 # 就是几级标题，# 后面记得加一个空格：

1
2
3
4
5
6
# 一级标题（文章一般只有一个，Hexo 会自动用文章标题生成）
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果就是本文右侧的目录结构。建议：不要跳级使用（比如 ## 直接跳到 ####），目录生成会更规范。

二、段落与换行

  • 分段：直接空一行即可
  • 段内换行：行末敲两个空格再回车，或者在下一行也写一句（大多数平台支持直接回车换行）
  • Markdown 源码里的多个空行、多余空格，最终都会被合并成一个空格——这是设计理念：内容归你，格式交给语法

三、强调：加粗、斜体、删除线

1
2
3
4
**这是加粗**
*这是斜体*
***这是加粗斜体***
~~这是删除线~~

效果：这是加粗、这是斜体、这是加粗斜体、这是删除线

四、列表

无序列表

用 -、* 或 + 开头（推荐统一用 -）：

1
2
3
- 苹果
- 香蕉
- 橘子
  • 苹果
  • 香蕉
  • 橘子

有序列表

用数字加 .：

1
2
3
1. 打开电脑
2. 写一篇文章
3. 双击发布脚本
  1. 打开电脑
  2. 写一篇文章
  3. 双击发布脚本

嵌套列表

子项前面缩进 2~4 个空格：

1
2
3
4
5
6
- 水果
  - 苹果
  - 香蕉
    - 产地：菲律宾
- 主食
  - 米饭
  • 水果
    • 苹果
    • 香蕉
      • 产地：菲律宾
  • 主食
    • 米饭

任务列表（勾选框）

1
2
- [x] 已完成：搭博客
- [ ] 未完成：写100篇文章
  • 已完成：搭博客
  • 未完成：写100篇文章

五、链接和图片

链接

1
2
[链接文字](https://example.com)
[带提示的链接](https://example.com "鼠标悬停会显示这句话")

效果：去 Cloudflare 官网

图片

比链接多一个感叹号 !：

1
2
![图片描述](图片地址)
![博客图标](https://blogtwo.pages.dev/img/butterfly-icon.png)

博客图标

建议：图片描述要认真写，图片挂了的时候会显示这段文字，也方便搜索引擎理解。

本地图片怎么放

在 blog/source/ 下建一个 img 文件夹，图片放进去，文章里这样引用：

1
![我的截图](/img/screenshot.png)

六、代码

行内代码

用反引号包起来（键盘左上角 Esc 下面那个键）：

1
运行 `npx hexo server` 启动本地预览

效果：运行 npx hexo server 启动本地预览

代码块

用三个反引号开头和结尾，开头反引号后面写语言名字，就能自动语法高亮：

1
2
3
4
```python
def hello():
    print("Hello, Blog!")
```
1
2
def hello():
    print("Hello, Blog!")
1
2
const blog = "blogtwo.pages.dev";
console.log(`我的博客地址：${blog}`);
1
git add -A && git commit -m "新文章" && git push

七、引用

用 > 开头，可以嵌套（>>）：

1
2
3
4
5
> 这是一句引用
> —— 某个智者

> 一级引用
>> 二级嵌套引用

这是一句引用
—— 某个智者

八、表格

用 | 分隔列，用第二行的 --- 定义表头，冒号控制对齐：

1
2
3
4
5
| 语法 | 用途 | 备注 |
|:-----|:----:|-----:|
| `**text**` | 加粗 | 左对齐 |
| `*text*` | 斜体 | 居中对齐 |
| `~~text~~` | 删除线 | 右对齐 |
语法 用途 备注
**text** 加粗 左对齐
*text* 斜体 居中对齐
~~text~~ 删除线 右对齐

冒号的位置：:--- 左对齐、:---: 居中、---: 右对齐。

九、分隔线

三个以上的 - 或 *（独占一行，上下最好空一行）：

1
---

效果就是上面那些横线。

十、转义字符

想显示 Markdown 的符号本身（而不是让它生效），前面加反斜杠 \：

1
\*\*这样就不会加粗了\*\*

效果：**这样就不会加粗了**

十一、Hexo 写作专用知识

Front Matter（文章头部信息）

每篇文章开头的 --- 包裹的区域叫 Front Matter，Hexo 靠它识别文章属性：

1
2
3
4
5
6
7
8
9
---
title: 文章标题          # 必填
date: 2026-11-08 04:30:00  # 发布时间，影响排序和归档
tags:                   # 标签，可以有多个
  - 教程
categories:             # 分类
  - 教程
description: 显示在首页的一句话摘要
---

推荐的写作习惯

  1. 一篇文章一个 .md 文件，文件名用英文（如 markdown-tutorial.md）
  2. Front Matter 里把 tags 和 categories 填上，方便归档和检索
  3. 长文章多用 ## 分节，读者好扫读
  4. 发布前可以运行 npx hexo server 在 localhost:4000 本地预览
  5. 确认没问题再双击 发布博客.bat

十二、速查表（Cheat Sheet）

想要的效果 写法
标题 ## 标题
加粗 **文字**
斜体 *文字*
删除线 ~~文字~~
行内代码 `代码`
代码块 三个反引号包裹
链接 [文字](网址)
图片 ![描述](图片网址)
引用 > 文字
无序列表 - 内容
有序列表 1. 内容
表格 见第八节
分隔线 ---

结语

Markdown 的核心语法就这么二三十个符号，写上三五篇你就会形成肌肉记忆。别怕忘记——忘了就回来看这篇，它就在你自己的博客上。

下一篇想写什么？现在就建个 .md 文件试试吧 ✍️