Markdown 语法

JeremyJone ... 2023-7-13 大约 9 分钟

# Markdown 语法

# 标题

使用 # 设置标题。 支持 1-6 级标题,直接使用对应数量的 # 即可。

对于第一级和第二级标题,还可以通过 ===--- 的方式来实现。

示例:

# 一级标题

# 一级标题

## 二级标题

## 二级标题

...

###### 六级标题
1
2
3
4
5
6
7
8
9
10
11

效果:

# 一级标题

# 一级标题

# 二级标题

# 二级标题

# 三级标题

# 四级标题

# 五级标题
# 六级标题

# 目录

使用 [TOC],markdown 会根据标题生成目录,并根据目录级别,自动划分层级。

示例:

[TOC]
1

效果:

注意

有些编辑器或网站是区分大小写的,所以尽量使用大写格式来生成目录。

# 字体

# 加粗

使用 ** 将需要加粗的文字包裹起来即可。

示例:

这段文字,**这里**需要加粗
1

效果:

这段文字,这里需要加粗

# 斜体

使用 * 将需要斜体的文字包裹起来即可。

示例:

这段文字,*这里*需要斜体
1

效果:

这段文字,这里需要斜体

提示

如果需要加粗的斜体,可以通过 *** 实现。

# 删除线

使用 ~~ 将需要显示删除线的文字包裹起来即可。

示例:

这段文字,~~这里~~需要删除线
1

效果:

这段文字,这里需要删除线

# 重点

使用 == 将需要重点显示的文字包裹起来即可。

示例:

这段文字,==这里==是重点
1

效果:

这段文字,==这里==是重点

# 链接

# 文字链接

使用 [描述](地址) 的方式可以增加链接。

示例:

[这是一个链接](https://www.jeremyjone.com)
1

效果:

这是一个链接

# 内链接

有时候,文件内需要跳转到指定目录位置,也可以使用链接进行跳转。

链接部分使用 # + 目录名 来实现跳转,不论几级目录,都这样写。所以,目录中的名称不应该有重复,这样会引起不必要的奇异。

示例:

跳转到 [目录](#目录)
1

效果:

跳转到 目录

# 图片链接

使用 ![alt](图片地址) 的方式可以关联并展示一张图片,这适用于本地和远程。

示例:

![示例图片](https://desktop.jeremyjone.com/test/images/01.jpg)
1

效果:

示例图片

# 分割线

使用 *** 或者 --- 可以实现分割线。

示例:

---
---
1
2

效果:



# 注脚

注脚通常用于解释某些内容,类似书本中的注释、详解。

使用 [^keyword] 的方式添加注脚名,然后在文本的任意位置(通常在最下方)添加注脚内容。当然,注脚的内容永远显示在最下方。

示例:

这是一段 Markdown[^1]文本,它可以直接转为 HTML[^2],可以使用插件[^script]实现更丰富的功能。

[^1]: Markdown 是一种文本标记语言。
[^2]: HTML 是一种超文本标记语言。
[^script]: 用于 markdown 的插件。
1
2
3
4
5

效果:

这是一段 Markdown[1]文本,它可以直接转为 HTML[2],可以使用插件[3]实现更丰富的功能。

# 引用

使用 > 实现引用,多个 > 可以实现多级引用。

示例:

> 一级引用
>
> > 二级引用
> >
> > > 三级引用
> > > ...
> > >
> > > > > > > > > > > > > > > > > > > > n 级引用
1
2
3
4
5
6
7
8

效果:

一级引用

二级引用

三级引用

n 级引用

# 代码

代码内容是程序员必备,同时也可以突出一些重点内容。

# 行内代码块

通过 ` 可以将你希望的代码内容或者重点内容包裹起来,像这样:

示例:

这是一篇 `markdown` 文档。
1

效果:

这是一篇 markdown 文档。

# 行内代码块中特殊字符的处理方式

如果你希望的内容中如果包含 `,这就比较棘手了,不过这对于 markdown 很简单。使用 `` 来包裹包含 `的内容即可。同样的,你也可以使用 ` 来包裹具有 ``的内容。看上去它更像是一段绕口令,如果你对python熟悉,那么这样的方式应该并不陌生,它和python字符串的使用方式类似。

示例:

如何使用 `markdown``` ` `` 包裹到行内块?这个问题很简单,使用 ` `` `的方式即可。
1

效果:

如何使用 markdown` 包裹到行内块?这个问题很简单,使用 ``的方式即可。

提示

``` 本身的功能是一样的,它们都可以包裹任意内容,区别是它们可以包含对方。

# 代码块

这是一个比较单独的区域,通过 ```可以定义一个单独的代码区域。同时,在 ``` 后面跟上语言名称,可以根据对应的代码规则,高亮代码内容。

示例:

```js
    function() {
        /* content */
    }
```
1
2
3
4
5

效果:

function() {
   /* content */
}
1
2
3

提示

markdown 支持的语言是通过不同插件实现的,不同编辑器、网站,支持的都不尽相同,可以查看 Prism 完整的语言列表:语言列表

# 多代码块的处理

有时候我们的文档中需要在代码块中嵌套内层代码块,这时的方式与行内代码块类似,仍然使用 ` 来处理即可。

因为代码块使用的是 ```,我们可以在外层代码块多加一个 `,以此类推,有多少层可以添加多少个 `

示例(上面代码示例):

````markdown
```js
    function() {
        /* content */
    }
```
````
1
2
3
4
5
6
7

效果:

```js
    function() {
        /* content */
    }
```
1
2
3
4
5

# 列表

列表分为有序和无序,它们的功能是一样的,同时它们也可以混用,这很方便。

# 无序列表

使用 - + * 的任意一种方式都可以实现无序列表,并且支持多级内容,每一级使用至少 2 个空格缩进。

示例:

- 内容 1

* 内容 2

- 内容 3
  - 子内容 1
  * 子内容 2
  - 子内容 3
    - 子内容
1
2
3
4
5
6
7
8
9

效果:

  • 内容 1
  • 内容 2
  • 内容 3
    • 子内容 1
    • 子内容 2
    • 子内容 3
      • 子内容

# 有序列表

有序列表需要使用数字 1.(数字 + .) 的方式来显式的声明。多级内容使用至少 3 个空格缩进。

示例:

1. 内容 1
2. 内容 2
3. 内容 3
   1. 子内容 1
   2. 子内容 2
   3. 子内容 3
1
2
3
4
5
6

效果:

  1. 内容 1
  2. 内容 2
  3. 内容 3
    1. 子内容 1
    2. 子内容 2
    3. 子内容 3

:bulb: 小技巧

其实你可以使用自定义的有序文字来定义内容前的顺序数列,它更像是一个自定义的无序列表。

# Todo 列表

Todo 列表是常用的一种待办事宜列表,markdown 通过使用 [ ][x] 来表示 未完成已完成

示例:

- [x] 早上吃一个鸡蛋
- [ ] 中午定外卖要健康
- [ ] 晚上去超市买早餐
1
2
3

效果:

  • [x] 早上吃一个鸡蛋
  • [ ] 中午定外卖要健康
  • [ ] 晚上去超市买早餐

注意

它本质上是一个列表,所以不要忘记添加列表的 - 符号。

# 表格

在 markdown 上绘制表格是一件很简单的事情,它通过简单的 -|: 组合起来,就可以完成表格的绘制。

具体方式:

  • 使用 | 分割每一列的内容。有些编辑器是可以忽略两边的 |的。
  • 使用 - 分割表头和内容。
  • 使用 : 控制每一列的对齐方式,默认左对齐。

示例:

| 表头 1       |    表头 2    |       表头 3 |
| ------------ | :----------: | -----------: |
| 第一列的内容 | 第二列的内容 | 第三列的内容 |
| 内容 1       |    内容 2    |       内容 3 |
1
2
3
4

效果:

表头 1 表头 2 表头 3
第一列的内容 第二列的内容 第三列的内容
内容 1 内容 2 内容 3

# 利用 HTML 绘制更为复杂的表格

虽然这样的表格可以满足绝大多数情况,但有时候我们仍然需要更为复杂的合并情况。可以利用 HTMLtable 标签来实现。

当然,这需要一点点 HTML 的基础,不过没有关系,这很简单,下面代码对完全没有接触的人也很友好:

示例:

<table>
  <tr>
    <th width="20%">列宽 `width=20%`</th>
    <th width="45%" style="text-align:center">
      表头居中 `style="text-align:center"`
    </th>
    <th widht="20%" style="text-align:right">居右</th>
    <th widht="5%">列3</th>
  </tr>
  <tr>
    <td>设置背景色</td>
    <td bgcolor=rgb(92,184,92)>`bgcolor=rgb(92, 184, 92)`</td>
    <td bgcolor=#eea236>`bgcolor=#eea236`</td>
    <td bgcolor=pink>`bgcolor=pink`</td>
  </tr>
  <tr>
    <td>**合并列**</td>
    <td colspan="3" align="center">`起始列colspan=2` `align=center`</td>
  </tr>
  <tr>
    <td rowspan="3">**合并行** <br />`起始行rowspan=3`</td>
    <td align="center">`align=center`对`th`无效</td>
    <td>cell</td>
    <td>cell</td>
  </tr>
  <tr>
    <td style="text-align:right">`style="text-align:right"`</td>
    <td>cell</td>
    <td rowspan="2">合并行 `rowspan=2`</td>
  </tr>
  <tr>
    <td>cell</td>
    <td>cell</td>
  </tr>
  <tr>
    <td>cell</td>
    <td>cell</td>
    <td>cell</td>
    <td>cell</td>
  </tr>
</table>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

效果:

列宽 `width=20%` 表头居中 `style="text-align:center"` 居右 列3
设置背景色 `bgcolor=rgb(92, 184, 92)` `bgcolor=#eea236` `bgcolor=pink`
**合并列** `起始列colspan=2` `align=center`
**合并行**
`起始行rowspan=3`
`align=center`对`th`无效 cell cell
`style="text-align:right"` cell 合并行 `rowspan=2`
cell cell
cellcellcellcell

# 绘图

markdown 本身并不可以绘图,但是通过一些插件可以实现,具体内容参看对应的插件文档。

# 流程图

具体的流程图语法,参看:流程图语法 flowchart

    ```flow
    st=>start: 开始:>https://www.jeremyjone.com
    op=>operation: My Operation
    cond=>condition: Yes or No?
    e=>end
    st->op->cond
    cond(yes)->e
    cond(no)->op
    ```
1
2
3
4
5
6
7
8
9
st=>start: 开始:>https://www.jeremyjone.com
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
1
2
3
4
5
6
7

# 序列图

具体的序列图语法,参看:序列图语法 js-sequence-diagrams

# 公式

markdown 通过一系列的语法可以轻松绘制出复杂的公式。更多关于公式的语法,参看:数学公式语法 mathjax

示例:

$\sqrt[3]{\frac xy}$

$\left(\frac{\sqrt x}{y^3}\right)$

$\sum_{i=0}^n i^2 = \frac{(n^2+n)(2n+1)}{6}$
1
2
3
4
5

效果:

\(\sqrt[3]{\frac xy}\)

\(\left(\frac{\sqrt x}{y^3}\right)\)

\(\sum_{i=0}^n i^2 = \frac{(n^2+n)(2n+1)}{6}\)


  1. Markdown 是一种文本标记语言。 ↩︎

  2. HTML 是一种超文本标记语言。 ↩︎

  3. 用于 markdown 的插件。 ↩︎