Markdown 简明语法手册(1)

前言

初次接触Markdown,很多地方需要熟悉一下,转来这篇小教程,算是练练手,也为以后使用留个参考。

Cmd Markdown 简明语法手册


1. 斜体和粗体

使用 * 或 ** 包裹文字表示斜体和粗体。

示例:

​ 这是 斜体,这是 粗体

表现:

这是 斜体,这是 粗体

2. 分级标题

使用 === 表示一级标题,使用 — 表示二级标题。
你也可以选择在行首加井号表示不同级别的标题 (H1-H6),例如:# H1, ## H2, ### H3,#### H4。

示例:

这是一个一级标题

这是一个二级标题
-————————————————-

### 这是一个三级标题

表现:

这是一个一级标题

这是一个二级标题

这是一个三级标题

3. 外链接

使用 描述 的形式为文字增加外链接。

示例:

这是去往 本人博客 的链接。

表现:

这是去往 本人博客 的链接。

4. 无序列表

行首使用 * 或 + 或 - 开头表示无序列表。
行首使用 空格 缩进可添加二级列表

示例:

* 无序列表项一
﹏* 表项1(此行左侧有一个不可见的空格)
+ 无序列表项二
﹏+ 表项2(此行左侧有一个不可见的空格)
- 无序列表项三
﹏- 表项3(此行左侧有一个不可见的空格)

表现:

  • 无序列表项一
    • 表项1(此行左侧有一个不可见的空格)
  • 无序列表项二
    • 表项2(此行左侧有一个不可见的空格)
  • 无序列表项三
    • 表项3(此行左侧有一个不可见的空格)

5. 有序列表

行首使用 数字和点 开头表示有序列表。

示例:

\1. 有序列表项一
\2. 有序列表项二
\3. 有序列表项三

表现:

  1. 有序列表项一
  2. 有序列表项二
  3. 有序列表项三

6. 文字引用

行首使用 > 表示文字引用,使用多个 >> 可多级嵌套引用。

示例:

> 离离原上草,一岁一枯荣。
>> 野火烧不尽,春风吹又生。

表现:

离离原上草,一岁一枯荣。

野火烧不尽,春风吹又生。

7. 行内代码块

使用 代码 表示行内代码。

示例:

让我们聊聊 html

表现:

让我们聊聊 html

8. 代码块

行首使用 四个缩进空格 或 一个制表符(Tab) 开头表示代码块。
或在代码块前后一行使用 ``` 包裹代码块。

示例:

﹏﹏﹏﹏这是一个代码块 //此行左侧有四个不可见的空格。

```
这也是一个代码块
```

表现:

1
2
这是一个代码块    //此行左侧有四个不可见的空格。
这也是一个代码块

9. 插入图像

使用 ! [描述] (图片链接地址) 的形式插入图像。

示例:

! [我的Logo] (https://zha.li/logo.png)

表现:

我的Logo

10. 删除线

使用 ~~ 表示删除线。

示例:

这是一段错误的文本。

表现:

这是一段错误的文本。

11. 分割线

分割线最常使用就是三个或三个以上的 - 或 *

示例:

-——-


表现:



Cmd Markdown 高阶语法手册


1. 注脚

使用 [^keyword] 表示注脚,然后使用 [^keyword]: 表示注脚的解释。

示例:

这是一个注脚[^footnote]的样例。(注脚解释在页脚)

这是第二个注脚[^footnote2]的样例。(注脚解释在页脚)

[^footnote]: 这是一个 注脚解释文本
[^footnote2]: 这是另一个 注脚解释文本

表现:

这是一个注脚1的样例。(注脚解释在页脚)

这是第二个注脚2的样例。(注脚解释在页脚)

2. 表格支持

用 | 表示表格纵向边界,表头和表体用 - 隔开;用 : 进行对齐设置,在左边则表示左对齐,在右边则表示右对齐,两边都有:则表示居中,若不加 : 则默认左对齐。

  • —-:为右对齐
  • :—-为左对齐
  • :—:为居中对齐
  • —–为默认左对齐

示例:

1
2
3
4
5
| 项目        | 价格   |  数量  |
| -------- | -----: | :----: |
| 计算机 | \$1600 | 5 |
| 手机 | \$12 | 12 |
| 管线 | \$1 | 234 |

表现:

项目 价格 数量
计算机 $1600 5
手机 $12 12
管线 $1 234

3. Html 标签

支持在 Markdown 语法中嵌套 Html 标签,譬如,你可以用 Html 写一个纵跨两行的表格:

示例:

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
<table>
<tr>
<th rowspan="2">值班人员</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李强</td>
<td>张明</td>
<td>王平</td>
</tr>
</table>
<table>
<tr>
<th rowspan="2">值班人员</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李强</td>
<td>张明</td>
<td>王平</td>
</tr>
</table>

表现:

值班人员 星期一 星期二 星期三
李强 张明 王平
值班人员 星期一 星期二 星期三
李强 张明 王平

Markdown 简明语法手册(1)
http://he.mk/2021/11/14/Markdown 简明语法手册(1)/
作者
未必赢
发布于
2021年11月14日
许可协议