Markdown常用语法

阅读目录

• 一、Markdown 是什么?
• 二、Markdown 常用语法
• 一级标题
• 三、其它

markdown：写技术文档、个人博客和读书笔记都很好用的轻量级标记语言

回到顶部

一、Markdown 是什么?

Markdown 是一种轻量级标记语言，这个语言的目的是希望大家使用“易于阅读、易于撰写的纯文字格式，并选择性的转换成有效的 XHTML（或是 HTML）”。

Markdown 既可以用来写产品的中英文技术文档、使用说明，也可以用来写个人博客。许多网站都使用 Markdown 或是其变种，例如 GitHub、reddit、简书。

回到顶部

二、Markdown 常用语法

Markdown 的语法超级简单，两分钟了解一下就可上手。这里举几个例子告诉你有多简单：

1. 标题

通过输入特定数量的井号 "#" 即可实现不同级别的标题：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题

回到顶部

一级标题

二级标题

三级标题

四级标题

2. 列表

Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号均可实现。例如：

* PingCAP
* TiDB
* TiKV

• PingCAP
• TiDB
• TiKV

效果等同于：

+ PingCAP
+ TiDB
+ TiDB

还等同于：

- PingCAP
- TiDB
- TiKV

有序列表使用数字接一个英文句点即可实现。例如：

\1. PingCAP
\2. TiDB
\3. Database
显示效果如下：

1. PingCAP
2. TiDB
3. Database

3. 链接

行内链接实现方式：链接文字。例如：
[PingCAP · GitHub](https://github.com/pingcap)
显示效果如下：
PingCAP · GitHub

另外，还支持参考式链接，这里暂不详述。

4. 强调

Markdown 使用星号 "*" 和底线 "_" 来实现强调效果。例如：
前两个显示为斜体效果

*TiDB*

_TiDB_

后两个显示为加粗效果

**TiDB**

_TiDB_
显示效果如下：
TiDB
TiDB

5.转义字符

在正常段落中要原样输出以上符号，一般需要加反斜杠\在前。（连续两个反斜杠输出一个反斜杠。）
\#
#

回到顶部

三、其它

Markdown 语法还支持引用、图片、代码块等，不同的 Markdown 编辑器又有一些具体的扩展，足以满足沉浸式写作的排版要求。
如果你有写作需求，建议试一试，可以远离复杂排版的干扰，让你专心写作。
有哪些 Markdown 编辑器？
Markdown 编辑器有很多，这里介绍几种 Mac 平台、Windows 平台适用的编辑器和在线编辑器。大家可以试用一下，看看自己钟爱哪款。

Mac 平台：

1. MacDown
2. Typora
3. Ulysses
4. Mou

Windows 平台：

1. MarkdownPad
2. Typora

在线编辑器：

1. Dillinger.io
   Link: https://dillinger.io
2. Markable.in
   Link: https://markable.in
3. 有道云笔记
   Link: https://note.youdao.com