Markdown 写法大全

1. 标题

Markdown 使用 # 来表示标题，最多支持六级标题。

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2. 段落与换行

  • 段落之间需要空行来区分。
  • 若想在段落内换行，可以在行末加两个空格，然后回车。
1
2
3
4
5
6
这是一个段落。

这是另一个段落。

这是段落内的换行
比如这句话会换行。

3. 强调文本

  • 斜体：用一个星号 * 或者一个下划线 _ 包围文本。
  • 加粗：用两个星号 ** 或者两个下划线 __ 包围文本。
  • 斜体加粗：用三个星号 *** 包围文本。
1
2
3
4
5
*斜体* 或 _斜体_

**加粗** 或 __加粗__

***斜体加粗*** 或 ___斜体加粗___

4. 列表

无序列表

使用 -、+ 或 * 来创建无序列表。

1
2
3
4
5
- 项目 1
- 项目 2
  - 子项目 1
  - 子项目 2
- 项目 3

有序列表

使用数字加点 1. 来创建有序列表。

1
2
3
4
5
1. 第一项
2. 第二项
3. 第三项
   1. 子项 1
   2. 子项 2

5. 链接

  • 插入链接时，使用 [链接文字](URL) 格式。
  • 还可以添加标题，格式为 [链接文字](URL "标题")。
1
2
3
[Google](https://www.google.com)

[GitHub](https://github.com "GitHub 官网")

6. 图片

插入图片的语法与链接类似，不过前面多了一个 ! 符号。

1
2
3
![图片描述](图片URL)

![GitHub Logo](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png)

7. 代码

行内代码

使用反引号 ` 包围代码：

1
这是 `行内代码` 示例。

代码块

使用三个反引号 ``` 或者四个空格来表示多行代码。

1
2
3
```
这是一个代码块。
多行代码可以在这里显示。
1
2
3
4
5
6
7

或者：

```python
# 代码块可以指定语言，如 Python
def greet():
    print("Hello, world!")

8. 引用

使用 > 来表示引用：

1
2
> 这是一个引用。
> 可以包含多行。

9. 水平线

使用三个或更多的 -、* 或 _ 创建水平线。

1
2
3
---
或者
***

10. 任务列表

使用 [ ] 创建任务列表，已完成的任务使用 [x]。

1
2
3
- [x] 完成任务 1
- [ ] 未完成任务 2
- [x] 完成任务 3

11. 表格

使用 | 分隔列，- 分隔表头和表格内容。

1
2
3
4
5
| 姓名   | 年龄 | 城市  |
|--------|------|-------|
| 小明   | 25   | 北京  |
| 小红   | 30   | 上海  |
| 小强   | 22   | 广州  |

12. HTML 标签

虽然 Markdown 主要使用标记语法，但也可以直接在 Markdown 文件中插入 HTML 标签。例如：

1
<p>这是一个段落，包含 <strong>加粗</strong> 和 <em>斜体</em>。</p>

13. 自动链接

直接写网址，Markdown 会自动将其转化为可点击链接：

1
https://www.google.com

14. 嵌入 YouTube 视频

可以通过 HTML 的 <iframe> 标签嵌入 YouTube 视频（Markdown 本身不支持直接嵌入视频）。

1
<iframe width="560" height="315" src="https://www.youtube.com/embed/dQw4w9WgXcQ" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

15. 使用 • 圆点（无序列表）

Markdown 渲染器通常会把无序列表项渲染为圆点 •。你可以直接使用 HTML 标签来显示自定义无序列表样式：

1
2
3
4
5
<ul>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
</ul>

16. 自定义锚点链接

你可以在标题后手动添加 ID，生成自定义锚点链接：

1
## 这是一个标题 {#custom-id}

然后你可以通过 [链接文本](#custom-id) 来跳转。

进阶用法

1. 代码块指定语言

代码块可以指定语言，以便于语法高亮。例如，指定为 python：

1
2
def greet():
    print("Hello, world!")

2. 删除线

Markdown 支持删除线语法，使用 ~~ 来表示删除线：

1
~~这是一个被删除的文本~~

3. 脚注

某些 Markdown 渲染器支持脚注：

1
2
3
这是一个脚注[^1]。

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

4. 行内 HTML（嵌入表格等）

你可以直接在 Markdown 中嵌入 HTML 标签，例如，插入一个表格、iframe 等。

1
2
3
4
5
6
<table>
  <tr>
    <td>单元格 1</td>
    <td>单元格 2</td>
  </tr>
</table>

5. 数学公式

在一些支持 LaTeX 的 Markdown 渲染器中，可以使用数学公式语法。例如：

1
2
3
$$
E = mc^2
$$

总结

Markdown是一种轻量级的标记语言，它提供了一种简洁的方法来格式化文本。通过组合这些基本语法，你可以快速生成格式化文本，适用于文档、博客、笔记等多种场景。