Markdown 可食用语法

1. 标题

Markdown 支持六级标题,使用 # 符号标识:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一

二

三

四

五
六

2. 文本样式

2.1 粗体

使用 ** 或 __ 包围文本:

1
2
**粗体文本**
__粗体文本__

粗体文本

2.2 斜体

使用 * 或 _ 包围文本:

1
2
*斜体文本*
_斜体文本_

斜体文本

2.3 粗体加斜体

使用 *** 或 ___ 包围文本:

1
2
***粗体加斜体文本***
___粗体加斜体文本___

粗体加斜体文本

2.4 删除线

使用 ~~ 包围文本:

1
~~删除线文本~~

删除线文本

3. 列表

3.1 无序列表

使用 -、* 或 + 创建无序列表:

1
2
3
- 项目一
* 项目二
+ 项目三
  • 项目一
  • 项目二
  • 项目三

3.2 有序列表

使用数字+ . 创建有序列表:

1
2
3
1. 第一项
2. 第二项
3. 第三项
  1. 第一项
  2. 第二项
  3. 第三项

3.3 嵌套列表

将列表缩进即可创建嵌套列表:

1
2
3
4
5
6
1. 第一项
- 子项一
- 子项二
2. 第二项
- 子项三
- 子项四
  1. 第一项
    • 子项一
    • 子项二
  2. 第二项
    • 子项三
    • 子项四

4. 引用

使用 > 创建引用:

1
2
3
> 这是一个引用
>
> 这是第二段引用

这是一个引用

这是第二段引用

5. 代码

5.1 行内代码

使用反引号 ` 包围代码:

1
`行内代码`

def hello_world():
print("Hello, World!")

5.2 代码块

使用三个反引号包围代码块:

1
2
def hello_world():
print("Hello, World!")

6. 链接

6.1 行内链接

使用 [] 包围文本,() 包围链接:

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

百度

6.2 同一个文件内的链接🔗

1
2
# Heading name
[link](#heading-name)

[链接名]+(# + 小写标题名)

特殊符号全部省略 .,-\!?等, 空格 用 - 代替 6.2

7. 图片

使用 ![] 包围文本,() 包围图片链接:

1
![示例图片](https://www.example.com/image.jpg)
示例图片

8. 表格

使用 | 分隔列,- 分隔表头和内容:

1
2
3
4
| 头1 | 头2 | 头3 |
| --- | --- | --- |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
选修 男 女
物理 114 191
高数 514 919

9. 水平线

使用 ---、*** 或 ___ 创建水平线:

1
---

10. LaTeX

更详细的在下一篇

10.1 数学公式

使用 $ 或 $$ 包围数学表达式:

1
2
3
4
5
6
行内公式:$E = mc^2$

块级公式(默认居中):
$$
\frac{a}{b} = \sqrt{c}
$$

\(E = mc^2\) \[ \frac{a}{b} = \sqrt{c} \]

10.2 字体样式

1
2
3
$\textcolor{red}{红色字体}$
$\textbf{字体加粗}$
$\large{字号加大}$

\(\textcolor{red}{红色字体}\)
\(\textbf{字体加粗}\)
\(\large{字号加大}\)

11. 任务列表

使用 [ ] 创建未完成任务,使用 [x] 创建已完成任务:

1
2
- [ ] 未完成任务
- [x] 已完成任务

12. 转义字符

使用 \ 转义特殊字符:

1
\* 这是一个星号而不是斜体符号\*

* 这是一个星号而不是斜体符号*

可能的报错

Html

有些markdown版本可能不允许内嵌html

把文件 .markdownlint.json 的MD033 改成false

1
2
3
{
"MD033": false
}

__下划线 加粗和斜体用不了

.json MD050 改成false

1
2
3
{
"MD050": false
}