Markdown 常用语法参考
Markdown 常用语法参考
一、标题(Headings)
使用 #
符号表示标题级别(1-6级),#
后需加空格:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
二、文本格式(Text Formatting)
- 粗体:使用
**
或__
包围文本,如**粗体文本**
或__粗体文本__
。 - 斜体:使用
*
或_
包围文本,如*斜体文本*
或_斜体文本_
。 - 斜体加粗:使用
***
或___
包围文本,如***斜体加粗文本***
或___斜体加粗文本___
。 删除线:使用~~
包围文本,如~~删除线文本~~
。- 引用文本:使用
>
符号表示引用,如> 这是一个引用文本
。 - 分隔线:使用
---
、***
或___
创建分隔线,如---
。
三、列表(Lists)
- 无序列表:使用
-
、*
或+
符号表示无序列表项,如- 列表项1
、* 列表项2
、+ 列表项3
。 - 有序列表:使用数字和
.
表示有序列表项,如1. 列表项1
、2. 列表项2
、3. 列表项3
。 - 列表嵌套:在列表项前添加缩进(通常使用 2 个空格或 1 个制表符)表示列表嵌套,如:
- 列表项1- 嵌套列表项1- 嵌套列表项2
- 列表项2
1. 列表项11. 嵌套列表项12. 嵌套列表项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)
。 - 图片:使用

插入图片,如
。 - 图片和链接的区别:图片前面多了一个
!
符号。
六、表格(Tables)
使用 |
分隔列,使用 -
创建表头和表格内容的分隔线,如:
| 姓名 | 年龄 | 性别 |
| --- | --- | --- |
| 张三 | 25 | 男 |
| 李四 | 30 | 女 |
姓名 | 年龄 | 性别 |
---|---|---|
张三 | 25 | 男 |
李四 | 30 | 女 |
七、数学公式(Mathematical Formulas)
使用 $...$
包围行内公式,使用 $$...$$
包围块级公式,如:
```math
$E = mc^2$
```math
$$E = mc^2$$
- E=mc2E = mc^2E=mc2
- E=mc2E = mc^2E=mc2
八、其他(Others)
- 换行:在行尾添加两个或以上空格,然后按回车键。
- 注释:使用
<!-- 注释内容 -->
添加注释,注释内容不会在渲染后显示。 (ctrl + / ) - HTML 标签:可以直接使用 HTML 标签,如
<br>
换行,<b>
加粗等。 - 转义字符:使用反斜杠
\
转义特殊字符,如\*
显示为*
。 - 任务列表:使用
- [ ]
创建未完成任务,使用- [x]
创建已完成任务,如:
- [ ] 未完成任务
- [x] 已完成任务
九、图片显示问题
- 确保图片路径正确,建议使用相对路径或绝对路径。
- 确保图片文件存在且格式正确(如 PNG、JPG、GIF 等)。
- 使用支持 Markdown 渲染的编辑器或平台查看图片。
- 如果图片无法显示,尝试使用在线图片链接。
- 检查图片文件权限,确保有权限访问图片文件。
- 有些平台对图片大小有限制,确保图片大小在允许范围内。
- 如果图片仍然无法显示,尝试清除浏览器缓存或更换浏览器查看。