Markdown 简明语法

一. 什么是 Markdown?

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML 文档。——《维基百科》

特征

  1. Markdown 是一款轻量级标记语言,不同于 HTML ,它的语法简单易上手;
  2. Markdown 以纯文本格式编写文档。可以在任何支持 Markdown 编辑器的地方活动相同编辑效果,无需担心排版,专注内容;
  3. Markdown 通过添加一些简单的标识符,让文本具有恰到好处的格式,对内容简单排版友好;
  4. Markdown 核心特征就是删繁剪芜,简扼 + 精炼。

二. Markdown 相关软件推荐

Markdown 语法

  • 下文提到的所有标识符都为英文状态
  • 本篇内容仅涉及常用语法,严格遵循 GFM 规格
  • 本文使用 Markdown 编辑器为 Typora

三. 基本语法

3.1 标题

设置标题,只需要在文字前加 # 即可,# 的数量分别代表标题级别。一共支持六级标题。

语法:『#+空格+文本内容』

示例
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

3.2 斜体

需要倾斜的文字,左右两边分别用一个 * 号抱起来(无需空格,下同)。

语法:

  • * +文本内容+ * 』或
  • _ +文本内容+ _ (下划线)』
这是一段普通文本

_这里是一段斜体文本_
_这也是一段斜体文件_

3.3 粗体

将需要加粗的文字,左右两边分别用两个 * 号包起来。 语法:

3.4 斜体加粗

需要倾斜且加粗的文字,左右两边分别用三个 * 号包起来

3.5 删除线

需要加删除线的文字,左右两边分别用两个 ~~ 号包起来

示例:

语法示例
_文字倾斜效果_
**文字加粗效果**
**_文字倾斜加粗效果_**
~~文字增加删除线效果~~
展示效果 文字倾斜效果 文字加粗效果 文字倾斜加粗效果 文字增加删除线效果

3.6 引用

对某段文字进行引用,需要在文字前添加 “>” 即可。引用与引用可以多层嵌套,只需在内层叠加 “>” 即可。

语法示例
> 一级引用内容
> > 引用的内容
> > > 嵌套引用的内容
> > >  > 更多嵌套引用的内容
展示效果

一级引用内容

引用的内容

嵌套引用的内容

更多嵌套引用的内容

3.7 分割线

有多种方式实现分割线效果,三个或三个以上的 – 或者 * 都可以

语法示例
---
展示效果

3.8 超链接

在 [ ] 中添加文本标题,后面添加 (),括号内填写超链接

语法示例
[百度](htt://WWW.baidu.com)
[豆瓣](htt://WWW.douban.com)
展示效果 百度 豆瓣

3.9 列表

无序列表

用 – 或 * 或 + 即可实现无需列表,符号和文字间要有空格。

语法示例
- 列表1
- 列表2
- 列表3
展示效果
  • 列表1
  • 列表2
  • 列表3

有序列表

数字加点即可实现有序列表,符号和文字见同样要有空格

语法示例
1. 列表1
2. 列表2
3. 列表3
展示效果
  1. 列表1
  2. 列表2
  3. 列表3

列表嵌套

上一级与下一级列表之间敲三个空格即可

语法示例
1. 列表1
  2. 列表2
  3. 列表3
展示效果
  1. 列表1 2. 列表2 3. 列表3

四. 进阶语法

4.1 代码

单行代码

代码之间分别用分引号 ~(键盘 tab 键上面的按键,输入法需切换至英文模式)包起来

语法示例
`这里是单行代码`
展示效果 这里是单行代码

代码块

代码之间前后分别用三个反引号“` 包起来,且两边的反引号单独占一行

语法示例
    ```
    代码 A
    代码 B
    代码 C
    ```
展示效果
代码 A
代码 B
代码 C

4.2 表格

语法示例
    ```
    表头|表头|表头
    ---|:--:|---:
    内容|内容|内容
    ```

展示效果
表头表头表头
内容内容内容
​ 第二行分割表头和内容。

  • 有一个就行,为了对齐,多加了几个 文字默认居左 -两边加:表示文字居中 -右边加:表示文字居右 注:原生的语法两边都要用 | 包起来。此处省略
语法示例
    ```
    姓名|技能|排行
    --|:--:|--:
    刘备|哭|大哥
    关羽|打|二哥
    张飞|骂|三弟
    ```
展示效果
姓名技能排行
刘备大哥
关羽二哥
张飞三弟

4.3 图片

语法

与超链接语法相似,[ ] 前多一个 ! ,后面添加 ( ),括号内填写图片地址

注:

  • 图片名称就是显示在图片下面的文字,相当于对图片内容的解释。
  • 图片标题,当鼠标移到图片上时显示的内容。标题可加可不加
语法示例
![壁纸](http://qnimg.zhaobanxian.top/20210315141513.jpg "壁纸")
展示效果 壁纸

4.4 Emoji

可以用 : emoji: 格式输出 emoji 表情

语法示例
: horse:
展示效果 🐴

五. 更多语法

5.1 公式

5.2 流程图

待补充