Markdown语法

Markdown可以看做是有点文字样式和排版的TXT文本文件，因此学习很快，门槛极低。

这里将会介绍基础的Markdown语法，学会后即可撰写简单的文章。

需要注意的是，我们在写文本的时候大多写的是中文，然而中文下的标点为全角标点，如，。？！（）【】：；“”等，这些标点不被Markdown语法所认可，也无法转义。

此Wiki常用Markdown语法有：

1. 标题 [数个 "#" + 空格前置]

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

设置标题后，标题会在右侧的本页目录中分级显示，且可以跳转。

2. 段落

Markdown一段文字就是一个段落，要创建新段落，请至少回车两次，保证两段文字之间至少有一个空行。也可以使用HTML语法</br>换行（非必要不建议）。

3. 加粗 [用 "**" 包围]

**南开大学欢迎你**

南开大学欢迎你

可以对选中的文本按下Ctrl + B实现该效果。

4. 斜体 [用 "*" 包围]

*欢迎大佬补充*

欢迎大佬补充

（PS: 斜体并强调 [用 "***" 包围]）

可以对选中的文本按下Ctrl + I实现该效果。

5. 列表

列表有有序和无序之分。

有序列表使用[数字 + "." + 空格前置]。数字可以不连续，Markdown会自动修正数字顺序。嵌套使用TAB键，或者加三个空格。

列表1
列表2
1. 列表3
  1. 列表4
2. 列表5
列表6

1. 列表1
2. 列表2
   1. 列表3
      1. 列表4
   2. 列表5 
3. 列表6

无序列表使用["-" + 空格前置]。一个短横线表示一个点。嵌套列表请在开头加两个空格

无序列表1
无序列表2
- 无序列表2.1
- 无序列表2.2
  - 无序列表3

- 无序列表1
- 无序列表2
  - 无序列表2.1
- - 无序列表2.2
    - 无序列表3

有序和无序可嵌套，一般用TAB或者打出和上一级标题相同长度的空格。有序标题是3个空格，无序标题是2个空格。

主要任务
- 子任务A
- 子任务B
  1. 详细步骤1
  2. 详细步骤2
- 子任务C
次要任务

1. 主要任务
   - 子任务A
   - 子任务B
     1. 详细步骤1
     2. 详细步骤2
   - 子任务C
2. 次要任务

6. 链接

可用于访问内、外部资源、网页。如百度，入学准备

WIki内部资料引用为相对路径，即Frontmatter的 permalink ，或者是网址https://freshnkuer.wiki/pages/BasicContribution/中https://freshnkuer.wiki后面的部分，如/pages/BasicContribution/

[链接名称](链接地址)
[链接文字](链接地址 "可选的标题")
<链接地址>

[百度](www.baidu.com "百度一下你就知道")
[入学准备](/pages/Preparation)

7. 插入图片

Markdown 图片语法格式如下：

![替代文字](图片路径)
![替代文字](图片路径 "图片标题")

由于Markdown不支持图片大小设置，所以有时候会使用HTML的<img>标签。

本网站所有图片相对路径为\img\，也可以引用外部网络图片。

8. 表格

一个最简单的表格由表头行、分隔行和数据行组成，列与列之间用英文竖线|分隔，行首和行尾也各写一个|方便对齐。

A列	B列	C列
`# 标题`	一级标题	标题
`文字`	加粗	文字
`文字`	斜体	文字
`[文字](链接)`	插入链接	百度

| 语法           | 作用     | 效果                          |
| -------------- | -------- | ----------------------------- |
| `# 标题`       | 一级标题 | 标题                          |
| `**文字**`     | 加粗     | **文字**                      |
| `*文字*`       | 斜体     | *文字*                        |
| `[文字](链接)` | 插入链接 | [百度](https://www.baidu.com) |

第二行的分隔行使用短横线-，对数量没有要求，还可以配合冒号:控制每一列的对齐方式：

:--- 左对齐（默认）
:---: 居中对齐
---: 右对齐

左对齐	居中	右对齐
1	2	3

| 左对齐 | 居中  | 右对齐 |
| :----- | :---: | -----: |
| 1      |   2   |      3 |

单元格内同样可以使用加粗、斜体、链接等行内语法；如果需要在单元格内换行，可以使用 HTML 标签 </br>。

注意事项：

竖线、短横线、冒号都要使用英文符号，行首和行尾的竖线可以省略，但建议写上。
每一行的单元格数量最好保持一致，否则表格可能显示错乱。
表格前后请留一个空行，否则可能无法被正确识别为表格。

9. 卡片组件与图标短码

本站「群汇总」等页面使用 ::: cardlist 自定义容器：把其中的普通 Markdown 表格渲染为卡片。在卡片表格的单元格内，可以用图标短码手动插入对应品牌的图标，无需手写 HTML，且图标会与文字显示在同一行。

在单元格中写入 :名称: 即可被替换为对应的 SVG 图标：

短码	对应图标	常见用途
`:qq:`	QQ 图标	QQ 群号、QQ 联系方式
`:wechat:`	微信图标	微信号、微信群
`:feishu:`	飞书图标（官方 logo，单色品牌蓝）	飞书群、飞书文档/链接
`:mail:`	邮箱图标	邮箱地址
`:link:`	外链图标	普通网页链接

注意事项：

短码名称必须以小写字母开头（如 :qq:、:feishu:），后面可跟字母、数字或连字符。
多个短码可连续书写，例如 :qq::feishu: 会依次渲染两个图标。
名称若不在内置注册表中，文本会原样保留（不报错），例如 :abc: 仍显示为 :abc:。
普通冒号文本（如时间 12:00、比例 1:2）不受影响——因为短码正则要求名称以字母开头，不会误伤数字。
图标统一取站点品牌色，与整套图标风格一致；飞书图标为官方 logo 单色化，不再是之前的占位图标。
图标短码仅在 ::: cardlist 卡片块内的单元格生效，普通 Markdown 表格中不会被替换。

其他

更多语法如代码、引用块、图表绘制等请参考Markdown、菜鸟网站，进行系统学习。

HTML等前端内容较深入，且使用频率低，请自行学习。

Markdown语法 ​

1. 标题 [数个 "#" + 空格 前置] ​

2. 段落 ​

3. 加粗 [用 "**" 包围] ​

4. 斜体 [用 "*" 包围] ​

5. 列表 ​

6. 链接 ​

7. 插入图片 ​

8. 表格 ​

9. 卡片组件与图标短码 ​

其他 ​