快速掌握 Markdown 基础语法
XPoet 自由程序猿

什么是 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 中,如果一段文字被定义为标题,只需在这段文字前加 # 标记符。

例如:

  • # 一级标题
  • ## 二级标题
  • ## 三级标题
  • ……

以此类推,共六级标题,对应 HTMLH1 ~ H6

注意:# 和文字之间需加一个空格。

image

字体加粗

标记符:**__

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

例如:**字体加粗**__字体加粗__

image

斜体

标记符:*_

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

例如:*斜体*_斜体_

image

引用

标记符:>

只需在引用的文字内容前面加上 > 标记符,就可以出现引用的效果。

例如:> 我是引用的句子哦

image

列表

无序列表

标记符:-+*

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

image

有序列表

标记符:1.2.3. ……

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

image

链接

标记符:[]()

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

image

图片

标记符:![]()

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

image

代码

单行代码

标记符:` `

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

image

多行代码

标记符:``` ```

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

image

分割线

标记符:***---___

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

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

效果如下:

ColName1ColName2ColName3
ColValueColValueColValue
ColValueColValueColValue
ColValueColValueColValue
ColValueColValueColValue

表格列调整

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

参考代码:

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

效果如下:

ColName1ColName2ColName3
ColValueColValueColValue
ColValueColValueColValue
ColValueColValueColValue
ColValueColValueColValue

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

 Comments
Comment plugin failed to load
Loading comment plugin