Markdown 常用语法参考

Markdown 常用语法参考

一、标题（Headings）

使用 # 符号表示标题级别（1-6级），# 后需加空格：

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

二、文本格式（Text Formatting）

• 粗体：使用 ** 或 __ 包围文本，如 **粗体文本** 或 __粗体文本__。
• 斜体：使用 * 或 _ 包围文本，如 *斜体文本* 或 _斜体文本_。
• 斜体加粗：使用 *** 或 ___ 包围文本，如 ***斜体加粗文本*** 或 ___斜体加粗文本___。
• 删除线：使用 ~~ 包围文本，如 ~~删除线文本~~。
• 引用文本：使用 > 符号表示引用，如 > 这是一个引用文本。
• 分隔线：使用 ---、*** 或 ___ 创建分隔线，如 ---。

三、列表（Lists）

• 无序列表：使用 -、* 或 + 符号表示无序列表项，如 - 列表项1、* 列表项2、+ 列表项3。
• 有序列表：使用数字和 . 表示有序列表项，如 1. 列表项1、2. 列表项2、3. 列表项3。
• 列表嵌套：在列表项前添加缩进（通常使用 2 个空格或 1 个制表符）表示列表嵌套，如：

- 列表项1
  - 嵌套列表项1
  - 嵌套列表项2
- 列表项2  
1. 列表项1
   1. 嵌套列表项1
   2. 嵌套列表项2  
2. 列表项2   
    * 嵌套列表项1
    * 嵌套列表项2

四、代码（Code）

• 行内代码：使用反引号 包围代码，如 这是行内代码。
• 代码块：使用三个反引号 或 包围代码块，如：

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

• 代码块语法高亮：在代码块前添加语言标识符，如 ````cpp```表示 C++ 代码块。

五、链接和图片（Links and Images）

• 链接：使用 [链接文本](链接地址) 创建链接，如 [Google](https://www.google.com)。
• 图片：使用 ![图片描述](图片地址) 插入图片，如 ![Markdown 图片](https://markdown.com.cn/images/logo.png)。
• 图片和链接的区别：图片前面多了一个 ! 符号。

六、表格（Tables）

使用 | 分隔列，使用 - 创建表头和表格内容的分隔线，如：

| 姓名 | 年龄 | 性别 |
| --- | --- | --- |
| 张三 | 25 | 男 |
| 李四 | 30 | 女 |

七、数学公式（Mathematical Formulas）

使用 $...$ 包围行内公式，使用 $$...$$ 包围块级公式，如：

```math
$E = mc^2$

```math
$$E = mc^2$$

1. $E=m{c}^2$
2. $$E=m{c}^2$$

八、其他（Others）

• 换行：在行尾添加两个或以上空格，然后按回车键。
• 注释：使用 <!-- 注释内容 --> 添加注释，注释内容不会在渲染后显示。 (ctrl + / )
• HTML 标签：可以直接使用 HTML 标签，如 <br> 换行，<b> 加粗等。
• 转义字符：使用反斜杠 \ 转义特殊字符，如 \* 显示为 *。
• 任务列表：使用 - [ ] 创建未完成任务，使用 - [x] 创建已完成任务，如：

- [ ] 未完成任务
- [x] 已完成任务

九、图片显示问题

• 确保图片路径正确，建议使用相对路径或绝对路径。
• 确保图片文件存在且格式正确（如 PNG、JPG、GIF 等）。
• 使用支持 Markdown 渲染的编辑器或平台查看图片。
• 如果图片无法显示，尝试使用在线图片链接。
• 检查图片文件权限，确保有权限访问图片文件。
• 有些平台对图片大小有限制，确保图片大小在允许范围内。
• 如果图片仍然无法显示，尝试清除浏览器缓存或更换浏览器查看。