Markdown学习小结

---

概述

简介

Markdown 是一种轻量级标记语言，使用纯文本格式编写文档，拥有一定的排版能力，多种格式输出兼容不同的发布渠道，在图文类媒体发布中非常好用。例如微信公众号、知乎、简书、reddit 等平台都支持 Markdown，还可以用 Markdown 写博客甚至 Gitbook 在线图书。

编辑器

本课将使用 Typora 编辑器作为主力工具来讲解 Markdown 的用法，并针对不同平台，介绍多种工具来实现对接，比如 mdnice 来实现微信公众号排版。

---

Markdown 标题

标题语法

Markdown 标题分为 6 级，对应 HTML 中的 6 级标题，几级标题就用几个 # 号作为起始，跟上标题文字，比如一级标题就是 1 个 # 跟上文字。如下表所示。

Markdown	HTML 语法	显示效果
# 一级标题	<h1>一级标题</h1>	一级标题
## 二级标题	<h2>二级标题</h2>	二级标题
### 三级标题	<h3>三级标题</h3>	三级标题
#### 四级标题	<h4>四级标题</h4>	四级标题
##### 五级标题	<h5>五级标题</h5>	五级标题
###### 六级标题	<h6>六级标题</h6>	六级标题

替代语法

如果仅有两级标题则可以用 = 和 - 放在下一行分别表示一级标题和二级标题。如下表所示。

Markdown	HTML 语法	显示效果
一级标题 =======	<h1>一级标题</h1>	一级标题
二级标题 -------	<h2>二级标题</h2>	二级标题

---

Markdown 段落

段落语法

Markdown 中没有任何符号修饰的文本就是一个自然段落，值得注意的是 Markdown 中如果需要另起一段需要在两行文本中插入一个空行。如下表所示。

Markdown	HTML 语法	显示效果
我是一个段落 另一个段落	<p>我是一个段落</p> <p>另一个段落</p>	我是一个段落 另一个段落

换行

Markdown 中除了分段，还可以在段落内部实现换行，可以在段落最后空格 2 个以上再回车来实现。

---

Markdown 段落引用

在文章中引用别处的文字，或者引用别人的对话，可以使用引用段落。

Markdown	HTML 语法	显示效果
> 引用段落	<blockquote> <p>引用段落</p> </blockquote>	引用段落
> 引用段落	<blockquote> <p>引用段落</p> <blockquote> <p>嵌套引用 </p> </blockquote> </blockquote>	引用段落 嵌套引用

---

Markdown 文本样式

文本样式语法

文本样式是指在写文章的过程中，需要对部分文字进行强调或者应用不同风格的展示方法，比如加粗或者斜体等。

Markdown	HTML 语法	显示效果
**粗体**	<strong>粗体</strong>	粗体
*斜体*	<em>斜体</em>	斜体
***粗斜体***	<strong><em>粗斜体</em></strong>	粗斜体

---

Markdown 列表

有序列表

有序列表会自动创建编号的列表来列出内容。如下表所示。

Markdown	HTML 语法	显示效果
1. 第一项 2. 第二项	<ol> <li>第一项</li> <li>第二项</li> </ol>	第一项 第二项
1. 第一项 2. 第二项 1. 第一子项 2. 第二子项	<ol> <li>第一项</li> <li>第二项 <ol> <li>第一子项</li> <li>第二子项</li> </ol> </li> </ol>	第一项 第二项 第一子项 第二子项

无序列表

无序列表会自动创建没有编号的列表来列出内容。如下表所示。

Markdown	HTML 语法	显示效果
- 一项 - 二项	<ul> <li>一项</li> <li>二项</li> </ul>	一项 二项
- 一项 - 二项 - 一子项 - 二子项	<ul> <li>一项</li> <li>二项 <ul> <li>一子项</li> <li>二子项</li> </ul> </li> </ul>	一项 二项 一子项 二子项

---

Markdown 链接

在 Markdown 中可以增加其他页面的链接，链接可以指向其他网页，在部分工具中还可以指向其他由 Markdown 生成的文章页面。

1

[百度](https://www.baidu.com)

上面的 Markdown 显示为 百度 。

对于链接，还可以增加显示鼠标悬浮式的提示信息，对应 HTML 中的 title 即标题。

1

[百度](https://www.baidu.com "中文搜索引擎")

这是一个带标题的链接 -> 百度 。

如果不想起名字，想直接显示链接，则使用尖括号。

1

<https://www.baidu.com>

朴实无华的链接 -> https://www.baidu.com 。

---

Markdown 图片

图片与链接的添加方式非常相似，仅需要在链接的前面加入一个 ! 号即可渲染为图片。

1

![赛博朋克](http://qqpublic.qpic.cn/qq_public/0/0-2924823161-080E75AD27578A93D3DDDF29CB9C3E0C/0?fmt=jpg&size=62&h=470&w=900&ppv=1/0)

同样，如果你需要添加标题时，可以在链接后面空格加上一段文字。

1

![赛博朋克](http://qqpublic.qpic.cn/qq_public/0/0-2924823161-080E75AD27578A93D3DDDF29CB9C3E0C/0?fmt=jpg&size=62&h=470&w=900&ppv=1/0 "夜之城与 V 不得不说的故事")

---

Markdown 表格

Markdown 扩展功能中比较重要的一个就是表格，在 Markdown 中可以组合使用 | / - / : 符号来定义表格，其中 | 用于分隔列，- 则用于分隔表格题目以及表格内容，: 则定义文本对齐。

1 2 3 4

| 姓名 | 年龄 |
| ---- | ---- |
| 小白 | 18   |
| 小红 | 17   |

姓名	年龄
小白	18
小红	17

对齐

在分隔表格题目和内容的 - 中加入 : 可以来定义不同的对齐。

1 2 3

| 左对齐     |   局中对齐   |     右对齐 |
| :--------- | :----------: | ---------: |
| 左对齐内容 | 居中对齐内容 | 右对齐内容 |

左对齐	局中对齐	右对齐
左对齐内容	居中对齐内容	右对齐内容

---

其他

Markdown 可以支持多种扩展语法，包括任务列表、数学公式甚至流程图，而且 Markdown 支持直接使用 HTML 的标签。