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. 第二项
    1. 第一子项
    2. 第二子项		 <ol>
    <li>第一项</li>
    <li>第二项
        <ol>
            <li>第一子项</li>
            <li>第二子项</li>
        </ol>
    </li>
</ol>
  1. 第一项
  2. 第二项
    1. 第一子项
    2. 第二子项

无序列表

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

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 的标签。

进阶练习

请使用 Typora 参考 巴厘岛游记 编写一个 Markdown 文件。