Markdown 测试教程

一篇较详细的 Markdown 语法教程，方便在博客中写文章时查阅。本文覆盖常用语法与部分扩展（如 GFM），并附带示例与注意点。

一、标题

用 # 表示标题，数量代表级别（1～6 级）。# 与文字之间建议保留一个空格。

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

注意：部分解析器支持标题下加一行 ===（一级）或 ---（二级）的写法，但不如 # 通用，建议统一用 #。

二、段落与换行

段落：段落之间空一行，才会被识别为不同段落。
换行：同一段落内换行有两种方式：
- 行末加 两个空格 再回车（推荐）；
- 或直接回车（部分解析器会当作换行，但并非所有环境都支持）。

示例：
这是第一行（行末两个空格）
这是第二行。

下面空了一行，所以是新段落。

三、强调

效果	写法示例	说明
粗体	`文字` 或 `__文字__`	推荐用 `**`
斜体	`文字` 或 `_文字_`	推荐用 `*`
粗斜体	`*文字*`	粗体+斜体
~~删除线~~	`~~文字~~`	扩展语法，多数支持

注意：_ 在单词中间可能被当作斜体（如 some_thing），若不需要强调，可写 some\_thing 或改用下划线以外的符号。

四、列表

无序列表

用 -、* 或 + 开头，同一篇文章里建议统一用一种。子项缩进 2 或 4 个空格。

- 项目一
- 项目二
  - 子项 2.1
  - 子项 2.2
- 项目三

有序列表

数字 + . + 空格。数字不必连续，渲染后会自动按 1、2、3 显示。

1
2
3

1. 第一
1. 第二
1. 第三

嵌套列表

有序和无序可以混用，注意缩进一致：

1. 第一步
   - 子步骤 A
   - 子步骤 B
2. 第二步
   - 子步骤 A

任务列表（GFM 扩展）

用 - [ ] 和 - [x] 表示未完成与已完成（注意空格）：

1
2
3

- [x] 已读 Markdown 教程
- [x] 写好第一篇文章
- [ ] 配置评论插件

渲染效果：

已读 Markdown 教程
写好第一篇文章
配置评论插件

五、链接

行内式

[显示文字](URL "可选标题")，鼠标悬停可显示标题。

1 2	[小沐希官网](https://muxisoft.com) [带标题的链接](https://muxisoft.com "点击访问")

参考式

适合同一链接出现多次，先定义后引用：

1 2	[链接文字][ref] [ref]: https://muxisoft.com "可选标题"

直接写 URL

多数解析器会把尖括号包起来的 URL 转成可点击链接：
<https://muxisoft.com>

六、图片

语法：![替代文字](图片地址 "可选标题")。替代文字在图片无法加载或无障碍阅读时会用到。

1 2	![站点 logo](/assets/icon.svg) ![带标题的图](https://example.com/pic.png "说明文字")

图片+链接：先写图片语法，再包一层链接：

1	[![替代文字](图片地址)](链接地址)

七、引用

行首加 >，多行可每行都加，也可只在首行加。引用内可以再嵌套列表、代码等。

1 2	> 这是一段引用。 > 第二行仍在同一引用内。

嵌套引用：多写一层 >：

1
2
3

> 第一层引用
>> 第二层引用
>>> 第三层引用

八、代码

行内代码

用一对反引号 ` 包住内容，适合命令、变量名、短代码等。若内容本身含反引号，可用双反引号 ` `` 包住。

示例：在终端执行 npm run deploy，或设置变量 base_dir。

代码块

用 三个反引号 围住多行代码，并在开头可写语言标识，便于高亮：

```bash
cd ~/Desktop/code/muxi
npm run deploy
```

常见语言标识：bash、javascript、json、python、html、css、yaml、markdown 等。

在文章里写“反引号代码块”本身：用四个反引号围住三个反引号的那一行，避免被解析成代码块。

九、分割线

单独一行写至少三个 -、* 或 _，行内不要有其它内容（最多空格）：

1
2
3

---
***
___

十、表格

表头与内容行用 | 分隔，表头下方用 --- 分隔，并可指定对齐：

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

| 语法   | 说明     | 示例   |
| :----- | :------- | :----- |
| **粗体** | 加粗     | **文字** |
| *斜体*   | 倾斜     | *文字*   |
| `代码`  | 等宽     | `code`  |

语法	说明	示例
粗体	加粗	文字
斜体	倾斜	文字
`代码`	等宽	`code`

注意：表格前后最好空一行，否则可能和上下文粘连导致解析异常。

十一、转义

在以下字符前加反斜杠 \ 可输出本义，不参与 Markdown 解析：

1	\ ` * _ # [ ] ( ) < > { } \| . ! + -

例如：要显示 *星号* 而不变成斜体，可写 \*星号\*。

十二、扩展与杂项

脚注（部分解析器支持）

正文里需要说明的地方[^1]。  
另有一处说明[^2]。

[^1]: 这是第一条脚注内容。
[^2]: 这是第二条脚注内容。

使用 HTML

Markdown 里可以直接写 HTML，例如：

1	<kbd>Ctrl</kbd> + <kbd>C</kbd> 复制

效果：Ctrl + C 复制。
复杂版式或样式可适当用 HTML 补充，但不要过度依赖，以免迁移或换主题时出问题。

Emoji（GFM / 部分环境）

部分环境支持直接输入 Unicode emoji 或 :shortcode:，例如：:smile: :rocket:。是否生效取决于博客/解析器，可先本地预览确认。

十三、书写建议

标题层级：按 1→2→3 顺序用，不要跳级（例如不要从 ## 直接到 ####）。
列表缩进：子项用 2 或 4 个空格，全文统一。
代码块：尽量写上语言标识，便于高亮和阅读。
链接：长 URL 用参考式，正文更干净。
表格：列很多时考虑拆成多个小表或改用列表。
特殊字符：不确定是否触发语法时，用 \ 转义更稳妥。

十四、参考资源

掌握以上内容即可覆盖绝大多数博客与文档场景；遇到个别解析差异，以你使用的平台（如 Hexo/Stellar）渲染结果为准。