Markdown 完全指南：从入门到精通

Markdown 完全指南：从入门到精通

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML 文档。由于其简洁、高效的特性，Markdown 被广泛应用于文档编写、博客撰写、论坛发帖等场景。

目录

  1. 标题
  2. 段落与换行
  3. 文本样式
  4. 列表
  5. 链接与图片
  6. 代码
  7. 表格
  8. 分隔线与引用
  9. HTML 支持
  10. 扩展语法
  11. 实用技巧

标题

Markdown 支持两种标题格式：类 Setext 和类 atx 形式。

类 Atx 形式

在行首插入 1 到 6 个 #，对应到标题 1 到 6 级：

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

类 Setext 形式

对于一级和二级标题，可以使用以下方式：

1
2
3
4
5
一级标题
=========

二级标题
---------

段落与换行

段落是由一个或多个连续的文本行组成，前后要有一个以上的空行。

硬换行：在行尾添加两个或多个空格，然后按回车键。
这样就会创建一个换行。

或者直接使用空行来分隔段落。

文本样式

1
2
3
4
*斜体文本* 或 _斜体文本_
**粗体文本** 或 __粗体文本__
***粗斜体*** 或 ___粗斜体___
~~删除线文本~~

实际效果：

  • 斜体文本
  • 粗体文本
  • 粗斜体
  • 删除线文本

列表

无序列表

1
2
3
4
5
* 项目一
* 项目二
  * 子项目一
  * 子项目二
    * 更深层次项目

或者使用 - 或 +：

1
2
3
4
- 项目一
- 项目二
  - 子项目一
  - 子项目二

有序列表

1
2
3
4
5
1. 第一项
2. 第二项
3. 第三项
   1. 子项一
   2. 子项二

任务列表

1
2
3
- [ ] 未完成任务
- [x] 已完成任务
- [ ] 另一个任务

链接与图片

链接

1
2
3
4
[链接文本](URL "标题（可选）")

示例：
[Google](https://www.google.com "前往Google搜索")

或者使用参考式链接：

1
2
3
这是一个[示例链接][id]

[id]: https://example.com "可选标题"

图片

1
2
3
4
![替代文本](图片URL "标题（可选）")

示例：
![Markdown标志](https://markdown-here.com/img/icon256.png "Markdown标志")

代码

行内代码

1
使用 `printf()` 函数打印输出。

代码块

使用三个反引号 ``` 或三个波浪号 ~~~ 包裹代码：

1
2
3
4
5
6
7
```javascript
function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}
```

还可以指定语言以实现语法高亮：

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

表格

1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 |  单元格  | 单元格 |
| 单元格 |  单元格  | 单元格 |

或者简化写法：

1
2
3
4
左对齐 | 居中对齐 | 右对齐
:----- | :------: | -----:
单元格 |  单元格  | 单元格
单元格 |  单元格  | 单元格

分隔线与引用

分隔线

使用三个或多个星号、减号或下划线：

1
2
3
***
---
___

引用

1
2
3
4
5
6
> 这是一个引用
> 
> 多行引用
> 第二行
>
> > 嵌套引用

HTML 支持

Markdown 中可以直接使用 HTML 标签：

1
2
3
这是<strong>加粗</strong>文本，这是<em>斜体</em>文本。

<span style="color:red">红色文本</span>

扩展语法

许多 Markdown 处理器支持扩展语法：

脚注

1
2
3
这是一个带有脚注的句子[^1]。

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

定义列表

1
2
3
4
5
6
术语一
: 定义一

术语二
: 定义二
: 第二个定义

缩写

1
2
3
HTML 是超文本标记语言。

*[HTML]: 超文本标记语言

目录

某些处理器支持自动生成目录：

1
[TOC]

实用技巧

  1. 转义字符：使用反斜杠 \ 来转义特殊字符，如 \* 会显示为星号而不是斜体标记

  2. 自动链接：直接写入 URL 或邮箱地址会自动转换为链接：

    1
    2
    https://www.example.com
    email@example.com

  3. 避免意外格式化：在可能会被解析为 Markdown 的字符前使用反斜杠转义

  4. 使用 HTML 补充：当 Markdown 无法满足需求时，可以混合使用 HTML

  5. 保持简洁：Markdown 的优势在于简洁易读，避免过度使用复杂格式

Markdown 是一种简单而强大的工具，掌握它能大大提高文档编写效率。希望这篇指南能帮助你更好地使用 Markdown！

技术教程
Markdown 完全指南：从入门到精通
https://www.psnow.sbs/2025/09/15/Markdown-完全指南：从入门到精通/
作者
Psnow
发布于
2025年9月15日
许可协议