快速掌握 Markdown 基础语法

什么是 Markdown

Markdown 是一种「轻量级标记语言」,用途广泛,其使用简洁的语法代替常见的排版格式,从而能使我们专心于写作,在最大程度上提高效率。Markdown 的语法十分简单,常用的标记符号也不超过十个,学习成本极低,一旦熟悉这种语法规则,将会有一劳永逸的效果。

We believe that writing is about content, about what you want to say – not about fancy formatting.
我们坚信写作写的是内容,所思所想,而不是花样格式。

使用 Markdown 的优点

  • 专注你的文字内容而不是排版样式;
  • 纯文本内容,兼容所有的文本编辑器;
  • 可读、直观、通用性高、学习成本低;
  • 轻松导出 HTMLPDF 等格式的文件;
  • 随时可修改 .md 文件,不会因版本问题导致格式混乱;

Markdown 语法规则

标题

标记符 #
标题是文章最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只需在这段文字前加 # 标记符。
例如:
# 一级标题
## 二级标题
### 三级标题
……
以此类推,共六级标题,对应 HTML 的 h1 ~ h6。
注意:# 和文字之间需加一个空格。

标题

字体加粗

标记符 **__
在需要表示为粗体的文字内容,用两个 **__ 标记符包裹。
例如:**字体加粗**__字体加粗__

粗体

斜体

标记符 *_
在需要表示为斜体的文字内容,用两个 *_ 标记符包裹。
例如:*斜体*_斜体_

斜体

引用

标记符 >
只需在引用的文字内容前面加上 > 标记符,就可以出现引用的效果。
例如:> 我是引用的句子哦

引用

列表

无序列表

标记符 -+*
在需要表示为无序列表的文字前加 -+* 标记符。

无序列表

有序列表

标记符 1.2.3. ……
在需要表示为有序列表的文字前面添加加 1.2.3. …… 标记符。

有序列表

链接

标记符 []()
在 Markdown 中,插入链接,例如:[XPoet Blog](https://xtpoet.cn)

link

图片

标记符 ![]()
图片示例:![aliyun](https://img.alicdn.com/tfs/TB1Ly5oS3HqK1RjSZFPXXcwapXa-238-54.png)

image

代码

单行代码

标记符 ` `
需要引用代码时,如果引用的代码只有一行,可以用两个 ` 标记符将代码包裹起来。例如:

单行代码

多行代码

标记符:``` ```
多行代码,用两个 ``` 标记符将代码块包裹起来。例如:

多行代码

分割线

标记符:***---___
插入分割线,在一行中用三个以上的 *-_ 标记符来建立一个分隔线,行内不能有其他内容,分隔符独占一行。
分割线

删除线

标记符:~~
在需要添加删除线的文字内容,用两个 ~~ 标记符包裹。
例如:~~ABC~~ ABC

换行

标记符: 两个空格符回车
在 Markdown 中进行换行,需在文字后面键入 两个空格符回车

表格

在 Markdown 中插入表格的标记符比较复杂,大家直接看效果,需要用到时过来复制代码。

默认表格样式

参考代码:

1
2
3
4
5
6
ColName1 | ColName2 | ColName3
---------|----------|---------
ColValue | ColValue | ColValue
ColValue | ColValue | ColValue
ColValue | ColValue | ColValue
ColValue | ColValue | ColValue

效果如下:

ColName1 ColName2 ColName3
ColValue ColValue ColValue
ColValue ColValue ColValue
ColValue ColValue ColValue
ColValue ColValue ColValue
表格列调整

表格的列位置调整(默认左对齐,:------: 居中,------: 右对齐)
参考代码:

1
2
3
4
5
6
|ColName1 | ColName2 | ColName3|
|---------|:--------:|--------:|
|ColValue | ColValue | ColValue|
|ColValue | ColValue | ColValue|
|ColValue | ColValue | ColValue|
|ColValue | ColValue | ColValue|

效果如下:

ColName1 ColName2 ColName3
ColValue ColValue ColValue
ColValue ColValue ColValue
ColValue ColValue ColValue
ColValue ColValue ColValue

由于不同平台的 Markdown CSS 存在差异,实际显示效果跟本文也会有所不同。