Markdown 简明教程

主要内容

（一）Markdown 是什么

（二）为何要使用 Markdown

（三）如何使用 Markdown

（四）Markdown 编辑器

正文

（一）Markdown是什么

Markdown 是一种轻量级的 标记语言，以 纯文本 的形式编写文档，经过简洁的语法代替排版，而且能够导出 HTML、PDF 等格式。

（二）为何要使用 Markdown

• 格式清晰，读起来很舒服
• 语法简洁，编写时能够更专一于内容而非排版格式
• 纯文本形式，兼容全部的文本编辑器
• 可导出 HTML、PDF 等常见格式

（三）如何使用 Markdown

Markdown 的语法很是简单，主要包含如下几个部分：标题，段落，列表，强调，区块引用，代码区块，行内代码，分割线，连接，自动连接，图片，反斜杠，表格（扩展）。

1. 标题

标题有两种形式，一种形式为在文字下方添加 ===== 或 -----，分别表示一级标题和二级标题，如

一级标题 =====

二级标题 -----
复制代码

效果为

一级标题

二级标题

另外一种形式在标题前添加 #，添加一个 # 为一级标题，两个为二级标题，最多可至六级标题，如

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
复制代码

效果为

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 段落

一个 Markdown 段落是由一个或多个连续的文本行组成，段落先后要有一个以上没有文字的空行。使用 两个以上的空格加回车 可强制在 段落内换行。

段落的开头 不该该使用空格或者制表符（Tab）缩进。

3. 列表

Markdown 支持无序列表和有序列表。无序列表使用**星号*、加号+或减号-加至少一个空格或制表符（Tab）**做为列表标记，如

* 第一项
* 第二项
* 第三项
复制代码

效果为

• 第一项
• 第二项
• 第三项

有序列表使用 数字加点 . 再加至少一个空格或制表符 做为列表标记，如

1. 第一项
2. 第二项
3. 第三项
复制代码

效果为

1. 第一项
2. 第二项
3. 第三项

4. 强调

内容先后加上 星号 * 或 下划线_ 表示 强调。先后加一个星号或下划线为 斜体，两个为 粗体，三个为 粗斜体。如

*强调*
**强调**
***强调***
复制代码

效果为

强调

强调

强调

5. 区块引用

在段落的 第一行或每行开头 使用 > 表示引用，多个 > 表示嵌套，如

> 区块引用
>> 嵌套引用
复制代码

效果为

区块引用

嵌套引用

6. 代码区块

代码区块能够按以下格式输入

​```java public static void main(string[] args) { System.out.println("Hello, world"); } ​``` 复制代码

效果为

public static void main(string[] args) {
	System.out.println("Hello, world");
}
复制代码

7. 行内代码

先后含 反引号( ` ) 的内容为行内代码，如

`System.out.println("Hello, world")` 表示输出"Hello, world"。
复制代码

效果为

System.out.println("Hello, world") 表示输出"Hello, world"。

8. 分割线

三个或三个以上的星号 *、减号 -及下划线 _表示 分割线，中间可插入空格，如

***
- - -
复制代码

效果为

---

---

9. 连接

Markdown 支持两种形式的连接，行内式 和 参考式。
行内式 的连接文字用中括号 [] 标记，方括号后紧接小括号 () 标记网址连接，可在网址连接后用引号标记连接的 title 文字，如

[GitHub](https://github.com/ "Github")
复制代码

效果为

GitHub

参考式 的连接文字一样使用中括号 [] 标记，后面再接一个中括号标记连接的标识，须要在文件的任意处经过 [id]:url "title" 标记连接，如

[GitHub][1]  
[1]:https://github.com/ "GitHub"
复制代码

效果为

GitHub

10. 自动连接

Markdown 支持以 简短的自动连接 形式处理网址和电子邮箱，用尖括号 <> 标记，如

<https://github.com>
复制代码

效果为

github.com

11. 图片

Markdown 中标记图片的方式与标记连接相似，一样容许 行内式 和 参考式 两种形式，只需在连接文字的标记前加一个感叹号 !，如

![GitHub Icon](https://user-gold-cdn.xitu.io/2018/12/25/167e47b357d82282?w=512&h=512&f=png&s=33270 "GitHub Icon")
复制代码

效果为

GitHub Icon

遗憾的是 Markdown 不支持指定图片的宽高

12. 反斜杠

经过反斜杠 \ 可插入一些在 Markdown 语法中有其余意义的符号，如

\*先后为星号\*
复制代码

效果为

*先后为星号*

Markdown 支持在如下符号前加反斜杠 \ 来帮助插入普通的符号：

\	反斜杠   
`	反引号
*	星号
_	下划线
{}	大括号
[]	中括号
()	小括号
#	井号
+	加好
-	减号
.	英文句号
!	感叹号
复制代码

13. 表格(扩展)

表格为 扩展 的 Markdown 语法，| 表示纵向的边界，表头和内容之间用 三个或三个以上减号 - 隔开，可使用冒号 : 设置 对齐方式。冒号 : 在左边表示左对齐，在右边表示右对齐，两边都有冒号 : 表示居中，不使用冒号 : 时默认 左对齐，如

| name | gender | age |
| :---: | :---: | :---: |
| Jack | boy | 4 |
| Amy | girl | 5 |
复制代码

效果为

name	gender	age
Jack	boy	4
Amy	girl	5

（四）Markdown 编辑器

Mac 下好用的 Markdown 编辑器有不少，如 MacDown，Mou，Typora 等。

Windows 下可使用 MarkdownPad，马克飞象，有道云笔记 等。

Github 地址，欢迎 Star。