这是一份 Markdown 通用语法速查手册,覆盖了日常写作和开发文档(如 README、技术笔记)中最常用的所有语法。
Markdown 语法全示例
1. 标题(Headings)
使用 # 号,空格后接文字,共支持 6 级。
markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题2. 段落与换行
- 直接换行:段落间空一行即可。
- 软换行:行末加 两个空格 再回车,或使用
<br>标签。
markdown
这是第一段。
这是第二段(中间空行分隔)。
这是第一行(末尾两个空格)
这是紧跟的下一行。3. 文字样式(强调与修饰)
| 效果 | 语法 | 示例 |
|---|---|---|
| 加粗 | **文本** 或 __文本__ | 加粗文本 |
| 斜体 | *文本* 或 _文本_ | 斜体文本 |
| 粗斜体 | ***文本*** | 粗斜体 |
~~文本~~ | ||
| 下划线 | <u>文本</u>(HTML标签) | 下划线 |
行内代码 | `代码` | System.out.println() |
4. 列表(Lists)
无序列表(使用 - * +)
markdown
- 苹果
- 香蕉
- 子项(缩进 2 或 4 空格)
- 另一个子项
- 橙子有序列表(数字 + .)
markdown
1. 第一步
2. 第二步
1. 子步骤 2.1
2. 子步骤 2.2
3. 第三步任务列表(GFM 扩展,常用于 GitHub)
markdown
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项5. 引用(Blockquotes)
使用 > 号。
markdown
> 这是一级引用。
>
> > 这是嵌套的二级引用。
> >
> > > 三级引用嵌套。渲染效果:这是一段被引用的文本。
6. 链接与图片
行内链接
markdown
[百度](https://www.baidu.com "悬停提示文字")引用式链接(便于复用)
markdown
[我的博客][1]
[1]: https://example.com "博客描述"自动链接(尖括号)
markdown
<https://github.com>
<admin@example.com>图片(语法与链接类似,前面加 !)
markdown
7. 代码块(Code Fences)
使用三个反引号 ``` 包围,并可指定编程语言(实现语法高亮)。
markdown
```java
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, Markdown!");
}
}
其他语言示例:
```json
{
"name": "Markdown",
"version": 1.0
}8. 表格(Tables)
使用管道符 | 和横杠 - 绘制表头。冒号 : 控制对齐方式。
markdown
| 左对齐(默认) | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 苹果 | 5 元 | 水果 |
| 香蕉 | 3 元 | 水果 |
| 笔记本 | 5000 元 | 电子产品 || 左对齐(默认) | 居中对齐 | 右对齐 |
|---|---|---|
| 苹果 | 5 元 | 水果 |
| 香蕉 | 3 元 | 水果 |
| 笔记本 | 5000 元 | 电子产品 |
9. 分割线(Horizontal Rules)
单独一行使用三个或以上 ---、***、___。
markdown
---
***
___10. 转义字符(Escaping)
特殊字符前加反斜杠 \ 可显示原本符号。
markdown
\* 这不是斜体 \*
\# 这不是标题
\[这不是链接\]\(url)11. 高级扩展(GFM / 常见平台支持)
脚注(Footnote)
markdown
这是带脚注的文本[^1]。
[^1]: 这里是脚注的具体内容。目录跳转(锚点)
markdown
[跳转到标题](#标题名)
# 注意:标题名需转为英文小写,空格变连字符,中文可能需 URL 编码。HTML 标签混合
Markdown 支持内嵌 HTML,可实现更复杂的排版,例如:
html
<p align="center">这是一段居中文字</p>
<kbd>Ctrl</kbd> + <kbd>C</kbd>12. 数学公式(需平台开启支持,如 Typora / GitLab)
使用 $ 行内公式,$$ 块级公式(LaTeX 语法)。
markdown
行内公式:$E = mc^2$
块级公式:
$$
\sum_{i=1}^{n} i^2 = \frac{n(n+1)(2n+1)}{6}
$$💡 最佳实践小贴士
- 列表与子项:缩进统一使用 2 或 4 空格,避免混用 Tab。
- 空行分隔:不同区块(如标题与正文、列表与代码块)之间建议空一行,避免渲染出错。
- 代码块指定语言:一定要写语言名(如
javajsonsql),否则没有高亮。 - 兼容性:某些扩展语法(如任务列表、脚注)在纯文本编辑器或旧平台可能不生效,建议根据使用平台测试。