markdown语法

markdown语法

以下内容来源于 https://www.runoob.com/markdown/md-tutorial.html

目录

• 1 标题
  • 1.1 使用=和-标记"一级标题"和"二级标题"
  • 1.2 使用#标记标题
• 2. 换行, 字体, 分隔线, 等
  • 2.1 换行
  • 2.2 字体
  • 2.3 分隔线
  • 2.4 删除线
  • 2.5 下划线
  • 2.6 脚注
• 3. 列表
  • 3.1 无序列表
  • 3.2 有序列表
  • 3.3 列表嵌套
• 4. 区块
  • 4.1 区块基本使用
  • 4.2 区块嵌套
  • 4.3 区块中使用列表
  • 4.4 列表中使用区块
• 5. 代码
  • 5.1 段落文本中间的函数或代码片段
  • 5.2 代码区块
• 6. 链接
  • 6.1 直接写链接地址
  • 6.2 给链接取个名字
  • 6.3 通过变量设置链接
• 7. 图片
• 8. 表格
• 9. 高级技巧
  • 9.1 html元素
  • 9.2 转义
  • 9.3 公式

1 标题

标题有两种写法

1.1 使用=和-标记"一级标题"和"二级标题"

这种方法只能标记到二级标题, 无法标记三级标题或更低的标题.

这是一级标题
===========

这是二级标题
-----------

1.2 使用#标记标题

这种方法可以标记1~6级标题

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

2. 换行, 字体, 分隔线, 等

2.1 换行

段落和换行没有特殊格式, 直接换行即可.

一个或多个空行, 会展示为一个空行.

2.2 字体

*斜体文字*
_斜体文字_

**粗体文字**
__粗体文字__

***粗斜体文字***
___粗斜体文字___

2.3 分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

***

* * *

****

---

___

_ _ _

2.4 删除线

文字两端加两个波浪线.

正常文字
~~删除线文字~~

2.5 下划线

下划线可以通过 HTML 的 <u> 标签来实现:

<u>下划线文字</u>

2.6 脚注

脚注是对文本的补充说明, 格式如下:
(好像不怎么成功)

3. 列表

两种列表: 无序列表, 有序列表

3.1 无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记，这些标记后面要添加一个空格，然后再填写内容：

* 第一项
* 第二项
* 第三项


+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项

3.2 有序列表

有序列表使用数字并加上.号来表示,
前面的数字可以随意, markdown自动编号.

1. 第一项
1. 第二项
1. 第三项

3.3 列表嵌套

列表嵌套只需在子列表中的选项前面添加两个或四个空格即可:

1. 第一项
    + 1.1
    + 1.2
1. 第二项
    - 2.1
    - 2.2

4. 区块

Markdown 区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号

4.1 区块基本使用

> 区块引用
> 第二行区块
> 第三行区块
>

4.2 区块嵌套

区块还可以嵌套, 多个>表示多层嵌套, >之间可以有空格.

> 第一层区块
> > 第二层区块
>>> 第三层区块

4.3 区块中使用列表

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> 
> + 第一项
> + 第二项
> + 第三项

4.4 列表中使用区块

* 第一项
  > 区块内容
  > 区块内容
* 第二项
  > 区块内容
  > 区块内容

5. 代码

5.1 段落文本中间的函数或代码片段

使用反引号(`)把它包起来

这是一个`printf()`函数

5.2 代码区块

使用```把一段代码包裹起来,
还可以指定一种语言(也可以不指定).

\`\`\`
这是代码块
这是代码块
\`\`\`

或者代码块行首使用4个空格或一个Tab:

    这是代码块
    这是代码块
    这是代码块

6. 链接

6.1 直接写链接地址

在渲染后, 以下会显示为这个网址, 点击后进入某网站.

<https://www.baidu.com>

6.2 给链接取个名字

在渲染后, 以下会显示为"百毒", 点击后进入某网站.

[百毒](https://www.baidu.com)

6.3 通过变量设置链接

渲染后, 会显示"古狗"和"百毒"两个文本, 点击后进入对应网站.

[古狗][1]
[百毒][abcd]

[1]: http://www.google.com/
[abcd]: https://www.baidu.com/

7. 图片

图片的标记如下:

![图片替代文字](图片地址)
![图片替代文字](图片地址 "可选标题")

"图片替代文字"是指图片地址不可用时, 在本来图片的位置显示的内容.
"可选标题"是指鼠标移动到图片上时, 出现的提示框.

图片地址也可以像网址一样使用变量.

如果需要指定图片高度或宽度, 只能使用标签.

<img decoding="async" src="xx/xx/xx.png" width="50%">

8. 表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。

表头|表头
----|----
单元格|单元格
单元格|单元格
单元格|单元格

可以设置表格对齐方式

• -: 该列标题和内容右对齐
• :- 该列标题和内容左对齐
• :-: 该列标题和内容居中对齐

|左对齐|居中对齐|右对齐|
|:----|:--:|---:|
|单元格  |单元格  |单元格  |
|单元格1 |单元格1 |单元格1 |
|单元格12|单元格12|单元格12|

9. 高级技巧

9.1 html元素

mardown中可以直接使用HTML标签

9.2 转义

在markdown中有特殊意义的符号, 如果要显示它们, 需要使用转义符

**文本加粗**
\*\*正常显示星号\*\*

9.3 公式

Markdown Preview Enhanced 使用 KaTeX 或者 MathJax 来渲染数学表达式。

KaTeX 拥有比 MathJax 更快的性能，但是它却少了很多 MathJax 拥有的特性。你可以查看 KaTeX supported functions/symbols 来了解 KaTeX 支持那些符号和函数。

$...$ 或者 \(...\) 中的数学表达式将会在行内显示。
$$...$$ 或者 \[...\] 或者 ```math 中的数学表达式将会在块内显示。