Markdown 原生语法指南

一、标题 (Headings)

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

效果：

H1 标题

H2 标题

H3 标题

H4 标题

H5 标题

H6 标题

<!-- 注释：没有七级标题 -->

二、分隔线 (Horizontal Rules)

---
***
___

效果：

三、文本格式 (Text Formatting)

正常的文字
*斜体的文字*  _斜体的文字_
**粗体的文字** __粗体的文字__
^上标^ ~下标~ (部分扩展支持)
~~删去的文字~~
==高亮的文字== (部分扩展支持)

效果：
正常的文字
斜体的文字 斜体的文字
粗体的文字 粗体的文字
^上标^ ~下标~
~~删去的文字~~
==高亮的文字==

转义字符: \* \# \_ \- \` \\

效果：
转义字符: * # _ - ` \

四、注释 (Comments)

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

效果：

五、列表 (Lists)

有序列表

1. 条目1
2. 条目2
3. 条目3

效果：
1. 条目1 2. 条目2 3. 条目3

无序列表

- 条目a
* 条目b
+ 条目c

效果：
- 条目a * 条目b + 条目c

任务列表 (扩展语法)

- [ ] 未完成任务
- [x] 已完成任务
* [ ] 条目f
* [x] 条目g
+ [ ] 条目h
+ [x] 条目i

效果：
- [ ] 未完成任务 - [x] 已完成任务 * [ ] 条目f * [x] 条目g + [ ] 条目h + [x] 条目i

六、脚注 (Footnotes)

正文内容[^脚注]

[^脚注]: 解释内容

效果：
正文内容^脚注

七、链接 (Links)

1. 基础链接

[百度](https://www.baidu.com "搜索引擎")
[谷歌](https://google.com)

效果：
百度
 谷歌

2. 带标题文本的链接

[带标题的链接](https://example.com "悬停显示标题")

效果：
带标题的链接

3. 参考式链接

[参考式链接][google]  
[简写参考式链接][]  
[数字参考式][1]

[google]: https://google.com "Google搜索引擎"
[简写参考式链接]: https://example.com
[1]: https://example.org

效果：
参考式链接
 简写参考式链接
 数字参考式

4. 自动链接

<https://example.com>  
<contact@example.com>

效果：
https://example.com
contact@example.com

5. 本地资源链接

[本地文件](./document.pdf)  
[项目内图片](./images/logo.png)

效果：
本地文件
 项目内图片

6. 锚点链接 (文档内跳转)

[跳转到标题](#一级标题)  
[跳转到特定章节](#七链接--全面指南)

<!-- 注意：标题中的空格用-代替，标点符号通常被忽略 -->
[跳转到复杂标题](#文本格式-text-formatting)

效果：
跳转到标题
 跳转到特定章节
 跳转到复杂标题

7. 邮件链接

<contact@example.com>  
[联系我们](mailto:support@example.com)

效果：
contact@example.com
联系我们

8. 电话链接

[致电客服](tel:+1234567890)

效果：
致电客服

9. 带参数的URL

[带参数的链接](https://example.com?param=value&lang=en)

效果：
带参数的链接

10. 链接高级用法

[![带图标的链接](icon.png)](https://example.com)  
[**加粗链接**](https://example.com)  
[链接中包含`代码`](https://example.com)

效果：

加粗链接
链接中包含代码

11. 参考式链接放置位置

<!-- 参考式链接定义通常放在文档末尾 -->
[google]: https://google.com
[github]: https://github.com

链接使用最佳实践

可读性优先：对长URL使用参考式链接

[查看文档][doc-link]

[doc-link]: https://example.com/long/path/to/document

标题文本：重要链接添加悬停提示

[下载](https://example.com/download "最新版本下载")

相对路径：项目内资源使用相对路径
```
[配置文件](./config/settings.yaml)
```
锚点链接：长文档使用锚点导航
```
[返回顶部](#一标题-headings)
```
邮件防护：使用mailto防止爬虫抓取
```
[联系我们](mailto:contact@example.com)
```

链接检查：确保所有链接有效

<!-- 坏链示例 -->
[失效链接](https://nonexistent-domain.com)

特殊字符处理：URL中的空格使用%20

[带空格的文件](./path%20to%20file.txt)

参考式链接管理：集中管理所有参考链接

<!-- 文档末尾 -->
[github]: https://github.com
[gitlab]: https://gitlab.com
[docker]: https://hub.docker.com

八、图片 (Images)

![图片描述](./1.jpg "晚安")
![图片描述][图片地址]

[图片地址]: ./1.jpg "好梦"

效果：

九、代码 (Code)

行内代码

`#include<iostream>` 或 ``包含反引号的代码：`console.log()` ``

效果：
#include<iostream> 或包含反引号的代码：`console.log()`

代码块

```C++
#include<iostream>
int main(){
    std::cout<<"hello world!"<<std::endl;
    return 0;
}
```

效果：

#include<iostream>
int main(){
    std::cout<<"hello world!"<<std::endl;
    return 0;
}

十、引用 (Blockquotes)

> 一级引用
>> 嵌套引用
> 
> 多行引用
> 第二行内容
>
> 包含**格式**和`代码`

效果：

一级引用

嵌套引用

多行引用
第二行内容

包含格式和代码

十一、表格 (Tables)

| 左对齐 | 居中对齐 | 右对齐 | 默认对齐 |
| :----- | :------: | -----: | -------- |
| 单元格1 | 单元格2 | 单元格3 | 单元格4 |
| **加粗** | `代码` | [链接](#) | 普通文本 |

效果：
| 左对齐 | 居中对齐 | 右对齐 | 默认对齐 | | :----- | :------: | -----: | -------- | | 单元格1 | 单元格2 | 单元格3 | 单元格4 | | 加粗 | 代码 | 链接 | 普通文本 |

十二、公式 (Formulas) - 需要数学支持

行内公式

质能方程$E=\frac{mc^2}{\sqrt{1-\frac{v^2}{c^2}}}$考虑了相对论效应

效果：
质能方程$E=\frac{mc^2}{\sqrt{1-\frac{v^2}{c^2}}}$考虑了相对论效应

行间公式

$$
<!-- latex -->
\nabla \cdot \mathbf{E} = \frac{\rho}{\varepsilon_0}
\\
\nabla \cdot \mathbf{B} = 0
\\
\nabla \times \mathbf{E} = -\frac{\partial \mathbf{B}}{\partial t}
\\
\nabla \times \mathbf{B} = \mu_0 \mathbf{J} + \mu_0 \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t} \tag{1}
$$

效果：
$$ % latex \nabla \cdot \mathbf{E} = \frac{\rho}{\varepsilon_0} \ \nabla \cdot \mathbf{B} = 0 \ \nabla \times \mathbf{E} = -\frac{\partial \mathbf{B}}{\partial t} \ \nabla \times \mathbf{B} = \mu_0 \mathbf{J} + \mu_0 \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t} \tag{1} $$