Markdown | 入门教程
更新: 4/5/2025 字数: 0 字 时长: 0 分钟
现代汉语就像用脏了的人民币，要用 Markdown 洗一洗。Markdown 是一种轻量级标记语言。你不需要关心标题多大字号、段前距多少、列表缩进几格，只要在纯文本前后增加一些标记符号（例如 # - * >），就能毫不费力地写出工整精美的文章。
优势
易学易记
只要几分钟就可以 学会 Markdown，然后你可能再也不想碰 Word 了。
专注写作
富文本编辑器（例如 Word）是通过点击图形化的功能按钮来实现排版，而 Markdown 则是通过标记字符去赋予文字不同格式。
易读易写，让任何与文字打交道的人专注于写作，不用操心排版。
格式统一
同一份 Word 文档，在
- 不同的设备：Windows、macOS、Android、iOS
- 不同的版本：旧版 Word、新版 Word
- 不同的软件：Microsoft Office、WPS
可能显示不一样的效果。
而 Markdown 可以一次编写，到处运行。
不管在电脑上，还是手机上，用 Markdown 写出来的文章都能带来舒适、统一、美好的阅读体验。
向外兼容
可以导出 PDF、Word、HTML、图片等格式分享给没有安装 Markdown 编辑器的人。
入门
一开始你只要记住以下符号（英文半角状态），就能写出排版清爽的文章了。
| 语法 | 标记结果 |
|---|---|
# + 空格 + 文本 | 一级标题 |
## + 空格 + 文本 | 二级标题 |
### + 空格 + 文本 | 三级标题 |
- + 空格 + 文本 | 无序列表 |
1 + . + 空格 + 文本 | 有序列表 |
> + 空格 + 文本 | 引用 |
如果有些文字需要特殊说明：
| 语法 | 标记结果 |
|---|---|
** + 加粗 + ** | 加粗 |
* + 斜体 + * | 斜体 |
~~ + 删除线 + ~~ |
其他：
| 语法 | 名称 |
|---|---|
---、***、+++ | 分割线 |
[TOC] | 内容目录 |
进阶
以上就是最基础的 Markdown 语法，普通用户看到这里就可以开始动笔尝试了。下面介绍一些 Markdown 的书写风格，让你的源码和文档更精美，更有条理。你不必一下子全部记住，需要实现哪个功能再来查阅或者问 Google 也不迟。
标题
层级
正文的标题从
##开始，#要留给整篇文章的标题（也可以不写）。这样的大纲结构也可以很方便地转换为思维导图，也符合 SEO（搜索引擎优化）的规则。markdown# 一级标题（h1）：文章的标题 ## 二级标题（h2）：正文的大标题 ### 三级标题（h3）：正文的小标题虽然 Markdown 最大支持
######六级标题，为了保持层级的简单，防止出现过于复杂的章节，请谨慎使用四级标题（除非是长文章）。如果三级标题下有并列性的内容，可以使用加粗、有序列表或无序列表代表末级标题。markdown短文章的标题层级 ### 正文的小标题 **三级标题 A** - 论据 1（五级标题） - 细分论据 1（六级标题） - 细分论据 2（六级标题） - 细分论据 3（六级标题） - 论据 2 - 论据 3 **三级标题 B** 1. 论据 2. 论据 3. 论据 **三级标题 C** - 论据 1 - 论据 2 - 论据 3markdown长文章的标题层级 ### 正文的小标题 #### 正文的三级标题 A #### 正文的三级标题 B #### 正文的三级标题 C二级标题下，不能直接出现四级标题。
标题要避免孤立编号（即同级标题只有一个）。
标题要简短，结尾不带标点符号。
源码中，标题前后空一行（段前距和段后距）。
大标题和小标题之间要有内容过渡（引出或概括下文）。
markdown# Title 开门见山地告诉读者这篇文章讲什么？ 一级标题作为文章的（页面）标题（H1），并且尽可能和文件名称保持一致。 如果文章很长，使用 [TOC] 生成目录。 ## What 先定义问题是什么？…… 正文从二级标题开始。 ## Why 为什么会出现这样的问题？…… ## How 下一步该怎么办？…… ## See also 文末别忘了贴上参考链接。
列表
无序列表
使用 ‐ 或 * 或 + 并跟随 1 个空格来表示无序列表。建议使用 ‐。
- 我是谁
- 我从哪里来
- 我到哪里去不建议
* 我是谁
* 我从哪里来
* 我到哪里去
---
+ 我是谁
+ 我从哪里来
+ 我到哪里去为什么
- 星号
*可能和加粗和斜体符号产生混淆。 - 加号
+不流行。
与其他语法结合使用
- **《春日》**：等闲识得东风面，万紫千红总是春。
- **《春草》**：萋萋总是无情物，吹绿东风又一年。
- **《墨梅》**：犹恨东风无意思，更吹烟雨暗黄昏。预览
- 《春日》：等闲识得东风面，万紫千红总是春。
- 《春草》：萋萋总是无情物，吹绿东风又一年。
- 《墨梅》：犹恨东风无意思，更吹烟雨暗黄昏。
有序列表
语法一（手动排序）
1. 斜月沉沉藏海雾，碣石潇湘无限路。
2. 不知乘月几人归，落月摇情满江树。
3. 春江潮水连海平，海上明月共潮生。预览
- 斜月沉沉藏海雾，碣石潇湘无限路。
- 不知乘月几人归，落月摇情满江树。
- 春江潮水连海平，海上明月共潮生。
对于比较短的、很少修改的有序列表，请按顺序标号，保持源码的可读性。
语法二（自动排序）
对于比较长的、可能会修改的列表（尤其是很长的嵌套列表），请使用「懒人编号法」。纵使有新的列表项「插队」，把序号弄乱了也没关系，Markdown 编辑器自动会对序号进行纠错。
1. Foo.
1. Bar.
1. Foofoo.
1. Barbar.
1. Gargar
1. Baz.预览
- Foo.
- Bar.
- Foofoo.
- Barbar.
- Gargar
- Baz.
嵌套列表
缩进 2 ~ 4 个空格或一个 Tab（推荐），可以嵌套列表。
示例一
1. 不知乘月几人归，落月摇情满江树。
- 与君吟弄风月，端不负平生。
- 对秋深，离恨苦，数夜满庭风雨。
- 五月畲田收火米，三更津吏报潮鸡。
2. 人姝丽，粉香吹下，夜寒风细。
- 弓弦抱汉月，马足践胡尘。
- 寒月悲笳，万里西风瀚海沙。
- 东堂坐见山，云风相吹嘘。
3. 沅溪夏晚足凉风，春酒相携就竹丛。
- 白发渔樵江渚上，惯看秋月春风。
- 归来独卧逍遥夜，梦里相逢酩酊天。
- 致君尧舜上，再使风俗淳。预览
- 不知乘月几人归，落月摇情满江树。
- 与君吟弄风月，端不负平生。
- 对秋深，离恨苦，数夜满庭风雨。
- 五月畲田收火米，三更津吏报潮鸡。
- 人姝丽，粉香吹下，夜寒风细。
- 弓弦抱汉月，马足践胡尘。
- 寒月悲笳，万里西风瀚海沙。
- 东堂坐见山，云风相吹嘘。
- 沅溪夏晚足凉风，春酒相携就竹丛。
- 白发渔樵江渚上，惯看秋月春风。
- 归来独卧逍遥夜，梦里相逢酩酊天。
- 致君尧舜上，再使风俗淳。
示例二
- 栏目
> - 排版美学
> - 数字生活
> - 日志随笔
- 联系方式
> - Email：***@gmail.com
> - Telegram：t.me/***
> - WeChat：***预览
栏目
- 排版美学
- 数字生活
- 日志随笔
联系方式
- Email：***@gmail.com
- Telegram：t.me/***
- WeChat：***
Tips
Tab缩进一级Shift+Tab提升一级
任务列表
语法
- [ ] 纯牛奶
- [x] 西瓜
- [ ] 鸡蛋
- [x] 保鲜膜
- [ ] 猪肉预览
- [ ] 纯牛奶
- [x] 西瓜
- [ ] 鸡蛋
- [x] 保鲜膜
- [ ] 猪肉
引用
在每一行使用 > 符号，包括换行的句子。
> 我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。
>
> by 毛泽东：《为人民服务》（1944 年 9 月 8 日）我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。
by 毛泽东：《为人民服务》（1944 年 9 月 8 日）
表格
语法
| 左对齐 | 居中对齐 | 右对齐 |
| :--------------- | :------------------------------------------------: | -----: |
| **加粗** | [插入链接](https://lisir.me/) | ￥5.7 |
| 换行 <br> 下一行 |  | ￥10.4 |预览
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 加粗 | 插入链接 | ￥5.7 |
| 换行 下一行 |  | ￥10.4 |
注释
- Markdown 是轻量级的标记语言，所以不支持合并和拆分单元格。
- 对于复杂表格，你可以在 Markdown 编辑器中使用 HTML 的
<table>标签标记。 - 输入
<br>可以换行（但不建议使用）。 - 把 Excel 表格复制粘贴到某些 Markdown 编辑器可以直接转换为 Markdown 形式的表格。
链接
语法
[LI SIR - 个人博客](https://lisir.me/)图片
语法
预览
Markdown 是一种纯文本标记语言，图片功能注定是它的弱项。
代码
行内代码
用 2 个重音符 `（backtick，在 Tab 键上方）包裹
`Markdown` 是一种轻量级标记语言。预览
Markdown 是一种轻量级标记语言。
用两个 ` 包裹，才能显示 `：
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``预览
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`
重音符前后空一格
- 推荐：使用键盘快捷键 `Ctrl + D` 可以将当前网页保存为书签。
- 反对：使用键盘快捷键`Ctrl + D`可以将当前网页保存为书签。预览
- 推荐：使用键盘快捷键
Ctrl + D可以将当前网页保存为书签。 - 反对：使用键盘快捷键
Ctrl + D可以将当前网页保存为书签。
代码块
将 3 个重音符 ` 置于代码块的首行和末行。首行的重音符后面可接代码语言名称，例如 ```python，以达到相应的代码高亮效果。
```python
print "Hello, Python!"
```预览
print "Hello, Python!"diff 代码对比
```diff
function addTwoNumbers (num1, num2) {
- return 1 + 2
+ return num1 + num2
}
```预览
function addTwoNumbers (num1, num2) {
- return 1 + 2
+ return num1 + num2
}换行
在行末使用 空格（两个以上），就可以实现强制换行，此语法适用于大部分 Markdown 编辑器。
硬换行在文档被导出时将被保留，且没有换段的段后距。
`enticing` [ɪn'taɪsɪŋ] （事物）诱人的，有吸引力的；迷人的
- Her neck was short but rounded and her arms plump and enticing. `两个空格`
她的脖子短，但浑圆可爱；两臂丰腴，也很动人。by《飘》
- This was enticing to Wozniak, even more than any prospect of getting rich. `两个空格`
这句话对沃兹尼亚克的诱惑太大了，比变成富人的诱惑还要大。by《乔布斯传》enticing [ɪn'taɪsɪŋ] （事物）诱人的，有吸引力的；迷人的
Her neck was short but rounded and her arms plump and enticing.
她的脖子短，但浑圆可爱；两臂丰腴，也很动人。by《飘》This was enticing to Wozniak, even more than any prospect of getting rich.
这句话对沃兹尼亚克的诱惑太大了，比变成富人的诱惑还要大。by《乔布斯传》
假如生活欺骗了你， `两个空格`
不要悲伤，不要心急！ `两个空格`
忧郁的日子里须要镇静： `两个空格`
相信吧，快乐的日子将会来临！ `两个空格`
心儿永远向往着未来； `两个空格`
现在却常是忧郁。 `两个空格`
一切都是瞬息，一切都将会过去； `两个空格`
而那过去了的，就会成为亲切的怀恋。 `两个空格`
by 普希金假如生活欺骗了你，
不要悲伤，不要心急！
忧郁的日子里须要镇静：
相信吧，快乐的日子将会来临！
心儿永远向往着未来；
现在却常是忧郁。
一切都是瞬息，一切都将会过去；
而那过去了的，就会成为亲切的怀恋。
by 普希金
贡献者
wkwbk