Markdown 扩展语法

合集 - Markdown 语法简明教程(3)

1.Markdown 基础语法2024-10-18

2.Markdown 扩展语法2024-10-18

3.Markdown 书写规范2024-10-11

收起

Markdown 扩展语法

注意： 在使用这些扩展语法前，请检查您的应用程序是否支持。 并非所有的 Markdown 编辑器都支持下面的这些扩展语法。

表格

要创建表格，请使用连字符 - 创建表头，使用管道符 | 分隔每列。 例如：

|学号|姓名|性别|年龄|学分|
|---|---|---|---|---|
|001|张三|男|21|87|
|002|李四|女|23|95|

在连字符一行加入冒号 : 可改变单元格对齐方式。 例如：

|:--|       # 左对齐（默认方式）
|:-:|       # 居中对齐
|--:|       # 右对齐

代码块

使用三个反引号 ` 或三个波浪号 ~ 包含代码可以生成代码块。 例如：

```
{
    "firstName": "John",
    "lastName": "Smith",
    "age": 23
}
```

~~~
使用三个波浪号 ~ 也可以生成代码块。
~~~

许多 Markdown 编辑器都支持代码块语法高亮，要实现此功能，请在代码块前指定一种语言。 例如：

```cpp
#include <iostream>
int main() {
    using namespace std;
    cout << "Hello World" << endl;
    return 0;
}
```

输出效果：

#include <iostream>
int main() {
    using namespace std;
    cout << "Hello World" << endl;
    return 0;
}

脚注

脚注可以为您的文档添加注释内容，使文档更加规范。 脚注由引用和注释两部分组成，引用出现在正文中，注释一般放在页面底部。 脚注创建后，引用自动编号，单击引用会跳转至相应的注释位置。

引用创建方式： [^文本]
符号 ^ 和右边文本称为"标识符"，标识符可以是数字和文本。 标识符用于关联引用与注释内容，注释按照创建顺序自动编号。

注释创建方式： [^文本]: 注释内容
使用相同方式创建注释，紧跟着一个冒号，然后是详细的注释内容。

这是一个数字脚注[^1]，  
这是一个文本脚注[^长段落]，

好多内容...  

[^1]: 这是一个简单的脚注，使用数字做编号。
[^长段落]: 这是一个文本脚注，使文档结构更加清晰、可读。

注意： 标识符不能包含空格、制表符。

任务列表

任务列表可以使您方便的创建带有复选框的列表。 在支持任务列表的 Markdown 编辑器中，复选框一般显示在任务内容的左边。

- [ ] 准备执行的任务
- [ ] 正在执行的任务
- [x] 已经完成的任务

注意，方括号的前、后各有一个空格，方括号内部也需要一个空格或符号 x。 添加符号 x 的复选框会出现一个对勾符号 √。

删除线

您可以在文档的某些字词中心显示一条水平线表示“删除”该部分。 要实现这种效果，可以在要“删除”的字词前后各使用两个波浪号 ~~。 例如：

后天同学聚会，~~别人可以不参加但~~你必须到场！