Wiki

外观

一、标准语法 (CommonMark) ​

1. 标题 ​

markdown
# H1 一级标题
## H2 二级标题
### H3 三级标题
#### H4 四级标题
##### H5 五级标题
###### H6 六级标题

替代语法（仅限 H1/H2）：
markdown
H1 标题
=======

H2 标题
-------

2. 段落与换行 ​

markdown
这是一个段落。段落之间用空行分隔。

这是第二个段落。
在末尾加两个空格  
可以实现强制换行。

3. 强调 ​

markdown
*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___

~~删除线~~（非标准，但广泛支持）

4. 列表 ​

无序列表：

markdown
- 项目 1
- 项目 2
  - 嵌套项目
  - 嵌套项目
- 项目 3

* 也可以用星号
+ 或加号

有序列表：

markdown
1. 第一项
2. 第二项
   1. 嵌套项
   2. 嵌套项
3. 第三项

<!-- 数字不必连续，渲染时会自动排序 -->
1. 第一项
5. 第二项
3. 第三项

5. 链接 ​

markdown
[链接文字](https://example.com)
[链接文字](https://example.com "悬停提示")
[相对路径](./file.md)
[锚点链接](#标题)

<!-- 引用式链接 -->
[链接文字][id]
[id]: https://example.com "悬停提示"

<!-- 自动链接 -->
<https://example.com>
<email@example.com>

6. 图片 ​

markdown
![替代文字](https://example.com/image.png)
![替代文字](https://example.com/image.png "标题")

<!-- 带链接的图片 -->
[![替代文字](image.png)](https://example.com)

7. 引用 ​

markdown
> 这是一段引用
> 可以有多行

> 嵌套引用
>> 第二层引用
> > > 第三层引用

8. 代码 ​

行内代码：

markdown
使用 `console.log()` 输出

代码块（缩进式）：

markdown
    缩进 4 个空格
    或一个 Tab
    就是代码块

围栏式代码块（推荐）：

markdown
```javascript
function hello() {
  console.log("Hello");
}
```

```python
print("Hello")
```

9. 分隔线 ​

markdown
---

***

___

- - - （需要空格分隔，避免被解析为列表）

10. 表格（扩展语法，但几乎通用） ​

markdown
| 表头 1 | 表头 2 | 表头 3 |
|--------|--------|--------|
| 单元格 | 单元格 | 单元格 |
| 左对齐 | 居中   | 右对齐 |

<!-- 对齐方式 -->
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容   |  内容    |  内容  |

11. 转义字符 ​

markdown
\* 不是斜体
\` 不是代码
\[ 不是链接
\\ 反斜杠本身
\# \- \. \! \| 等

**可转义字符：**  \   *   _   {}   []   ()   #   +   -   .   !   |   >   ``

二、扩展语法 ​

1. 任务列表 (Task List) ​

markdown
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一项任务
  - [x] 子任务

2. 脚注 (Footnote) ​

markdown
这是一个需要脚注的句子[^1]。

[^1]: 这是脚注内容。
[^2]: 脚注可以很长，多行缩进即可。
    第二行也要缩进。

也可以使用行内脚注^[这是行内脚注]。

3. 定义列表 (Definition List) ​

markdown
术语 1
: 定义 1

术语 2
: 定义 2a
: 定义 2b

4. 删除线 (Strikethrough) ​

markdown
~~这段文字被删除了~~

5. 下标与上标 ​

markdown
H~2~O  下标
X^2^   上标（部分解析器支持）

HTML 方式（更通用）：
markdown
H<sub>2</sub>O
X<sup>2</sup>

6. 高亮/标记 ​

markdown
==高亮文字==（部分解析器支持）
<mark>高亮文字</mark>（HTML）

7. 表情符号 (Emoji) ​

markdown
:smile: :heart: :+1: :rocket:

或使用 Unicode 直接输入：😀 ❤️ 👍 🚀

8. 目录 (TOC) ​

markdown
[[toc]]（部分解析器）
[TOC]（部分解析器）

9. 数学公式 (LaTeX) ​

行内公式：

markdown
$E = mc^2$

块级公式：

markdown
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

10. 图表 (Mermaid / 其他) ​

markdown
graph TD
    A[开始] --> B{判断}
    B -->|是| C[执行]
    B -->|否| D[结束]

11. 警告/提示框 (Admonition/Callout) ​

markdown
> [!NOTE]
> 这是一个提示框。

> [!WARNING]
> 这是一个警告框。

> [!TIP]
> 这是一个技巧提示。

> [!IMPORTANT]
> 重要信息。

> [!CAUTION]
> 注意风险。

部分平台语法：

markdown
::: tip 提示
这是提示内容
:::

::: warning 警告
这是警告内容
:::

::: danger 危险
这是危险内容
:::

12. 容器 (Container) ​

markdown
::: details 点击展开
这是隐藏的内容。
:::

13. 代码组 (Code Group / Tab) ​

markdown
::: code-group

```bash[npm]
npm install
```

```bash[yarn]
yarn install


```bash[pnpm]
pnpm install
:::

14. 导入代码片段 ​

markdown
<<< @/filepath.js{2,4-5}  <!-- 导入文件，并高亮第2行和第4-5行 -->

15. 属性标记 (Attribute) ​

markdown
# 标题 {#custom-id}

[链接](url){.class #id target="_blank"}

![图片](url){width=100 height=100}

16. 注释 ​

markdown
<!-- 这是 HTML 注释，不会显示在渲染结果中 -->

17. 嵌入内容 ​

markdown
@[youtube](dQw4w9WgXcQ)
@[bilibili](BV1xx411c7mD)
@[codepen](username/pen-id)

18. HTML 内嵌 ​

Markdown 中可以直接使用 HTML：

markdown
<div align="center">
  <h1>居中标题</h1>
  <p style="color: red;">红色文字</p>
</div>

<table>
  <tr><td>复杂表格</td></tr>
</table>

<details>
<summary>点击展开</summary>
隐藏内容
</details>