知识库

Appearance

复制自deepseek:)

Markdown 语法大全（基础+扩展） ​

Markdown 是一种轻量级标记语言，以下是其完整语法指南，包括基础语法和常见扩展功能。

基础语法 ​

1. 标题 ​

markdown
# H1 标题
## H2 标题
### H3 标题
#### H4 标题
##### H5 标题
###### H6 标题

替代语法（仅适用于H1和H2）：
H1
===

H2
---

2. 段落与换行 ​

markdown
这是一个段落。在Markdown中，段落由一个或多个连续的文本行组成。

要在段落内换行，需要在行尾添加两个或多个空格，
然后按回车键。

段落之间需要空一行。

3. 强调 ​

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

4. 列表 ​

无序列表 ​

markdown
- 项目一
- 项目二
  - 子项目（缩进2或4个空格）
* 也可以使用星号
+ 或加号

有序列表 ​

markdown
1. 第一项
2. 第二项
   1. 子项（缩进3个空格）
3. 第三项

5. 代码 ​

行内代码 ​

markdown
使用 `printf()` 函数。

代码块 ​

markdown
```语言（可选）
代码内容
```

或使用缩进（4个空格或1个制表符）：

function test() {
  console.log("缩进代码块");
}

6. 分隔线 ​

markdown
---
或
***
或
___

7. 链接 ​

markdown
[内联链接](https://example.com "可选标题")
[引用链接][id]

[id]: https://example.com "可选标题"

<https://example.com> （自动链接）

8. 图片 ​

markdown
![替代文本](图片URL "可选标题")

![引用式图片][logo]

[logo]: /path/to/img.jpg "Logo标题"

9. 引用 ​

markdown
> 这是一个引用。
> 可以跨多行。
>
> > 嵌套引用（前面加>和空格）

10. 内嵌HTML ​

markdown
<details>
<summary>点击展开</summary>
这里是被隐藏的内容
</details>

11. 转义字符 ​

markdown
\* 转义星号
\\ 反斜线
\` 反引号

扩展语法（非所有解析器都支持） ​

1. 表格 ​

markdown
| 语法      | 描述          | 测试文本     |
| --------- | ------------- | ------------ |
| 标题      | 这里文本      | 居中对齐     |
| 左对齐    | 右对齐        | 右对齐       |
| :---      | ---:          | :---:        |

对齐方式：

  • :--- 左对齐
  • ---: 右对齐
  • :---: 居中对齐

2. 任务列表（GitHub Flavored Markdown） ​

markdown
- [x] 完成作业
- [ ] 购买食材
- [ ] 准备晚餐

3. 删除线 ​

markdown
~~删除的文本~~

4. 脚注 ​

markdown
这是一个脚注的例子[^note].

[^note]: 这里是脚注的内容。

5. 定义列表 ​

markdown
术语一
: 定义一

术语二
: 定义二

6. 高亮（部分实现） ​

markdown
==高亮文本==

7. 上标和下标 ​

markdown
H~2~O （下标）
X^2^ （上标）

8. 自动链接增强 ​

markdown
https://example.com （无需尖括号）

9. Emoji（GitHub等支持） ​

markdown
:smile: :heart: :rocket:

10. 图表支持（部分扩展） ​

markdown
```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
```

11. 行内数学公式（KaTeX等支持） ​

markdown
行内公式：$E=mc^2$

块级公式：
$$
\int_a^b f(x)dx
$$

12. 目录（TOC，部分实现） ​

markdown
[TOC]

或

[[_TOC_]]

13. 属性（用于添加CSS类或ID） ​

markdown
## 标题 {#custom-id}

段落 {.class-name}

不同实现的差异 ​

  1. GitHub Flavored Markdown (GFM)

    • 支持表格、任务列表、删除线、自动链接
    • 代码高亮（通过语言标识符）
    • 不支持脚注、定义列表

  2. CommonMark

    • 标准化Markdown规范
    • 不支持表格、脚注等扩展语法

  3. Markdown Extra

    • 支持表格、定义列表、脚注
    • 支持属性（class/id）

  4. Pandoc Markdown

    • 支持几乎所有扩展
    • 包括表格、脚注、定义列表、数学公式等

注意：具体支持情况取决于您使用的Markdown解析器或平台。