常用Markdown 语法指南

欢迎来到 Markdown 的世界！Markdown 是一种轻量级标记语言，它允许你使用易读易写的纯文本格式来编写文档，然后转换成有效的 HTML 文档。它的设计哲学是 “可读即所见”。

下面，我们将通过丰富的示例和效果演示，带你全面掌握 Markdown 的核心语法。

标题 (Headings)

使用 # 符号来表示标题，从 # (一级标题) 到 ###### (六级标题)。

代码示例

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

效果演示

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

段落与换行 (Paragraphs & Line Breaks)

段落由一个或多个连续的文本行组成，段落之间用一个或多个空行分隔。
要创建一个换行（即在不开始新段落的情况下换行），可以在行尾添加两个或多个空格，然后按回车。

代码示例

1
2
3
4
5
这是第一段。段落之间用空行分隔。

这是第二段。
这是同一段落的第二行，但我在行尾加了两个空格，  
所以这行会换行显示，但仍属于同一个段落。

效果演示

这是第一段。段落之间用空行分隔。

这是第二段。
这是同一段落的第二行，但我在行尾加了两个空格，
所以这行会换行显示，但仍属于同一个段落。

强调 (Emphasis)

通过添加符号来使文字显示为粗体或斜体。

代码示例

1
2
3
*这是斜体文字* 或 _这也是斜体_
**这是粗体文字** 或 __这也是粗体__
***这是粗体且斜体*** 或 ___这也是粗体且斜体___

效果演示

这是斜体文字 或 这也是斜体
这是粗体文字 或 这也是粗体
这是粗体且斜体 或 这也是粗体且斜体

列表 (Lists)

Markdown 支持有序列表和无序列表。

无序列表 (Unordered List)

使用 -、* 或 + 作为标记。

有序列表 (Ordered List)

使用数字加英文句点 .。

代码示例

1
2
3
4
5
6
7
8
9
10
11
**无序列表：**
- 苹果
- 香蕉
  - 海南香蕉 （缩进两个空格表示子项）
  - 菲律宾香蕉
- 橘子

**有序列表：**
1. 第一步：准备食材
2. 第二步：烹饪
3. 第三步：享用美食

效果演示

无序列表：

  • 苹果
  • 香蕉
    • 海南香蕉
    • 菲律宾香蕉
  • 橘子

有序列表：

  1. 第一步：准备食材
  2. 第二步：烹饪
  3. 第三步：享用美食

链接文本放在 [] 中，URL 放在 () 中。还可以添加可选的标题文本。

代码示例

1
2
3
4
5
6
7
[这是一个指向百度的链接](https://www.baidu.com)

[这是一个带标题的链接](https://www.example.com "鼠标悬停时显示这个标题")

**引用类型的链接（使文档更干净）：**
[我是一个引用链接][1]
[1]: https://www.markdownguide.org "Markdown 官方指南"

效果演示

这是一个指向百度的链接
这是一个带标题的链接

引用类型的链接：
[我是一个引用链接][1]
[1]: https://www.markdownguide.org “Markdown 官方指南”

图片 (Images)

图片语法与链接非常相似，只是在前面加了一个感叹号 !。
格式：![替代文本](图片URL "可选标题")

代码示例

1
![这是一张示例图片](https://via.placeholder.com/150 "Placeholder 图片")

效果演示

这是一张示例图片

引用 (Blockquotes)

使用 > 符号表示引用内容。可以嵌套，也可以与其他 Markdown 元素结合使用。

代码示例

1
2
3
4
5
6
> 这是一段引用文本。
> 它可以跨越多行。
>
> > 这还是一个嵌套的引用。
>
> **引用内也可以使用粗体** 或 *斜体* 等格式。

效果演示

这是一段引用文本。
它可以跨越多行。

这还是一个嵌套的引用。

引用内也可以使用粗体 或 斜体 等格式。

代码 (Code)

  • 行内代码：使用反引号 ` 包裹。
  • 代码块：使用三个反引号 ``` 包裹，并可以指定语言以启用语法高亮。

代码示例

这是一段包含 `行内代码` 的文本。

```
def greet(name):
print(f”Hello, {name}!”)
greet(“World”)
```

效果演示

这是一段包含 行内代码 的文本。

1
2
3
def greet(name):
    print(f"Hello, {name}!")
greet("World")

表格 (Tables)

表格使用管道符 | 来分隔列，使用 - 来分隔表头和其他行。可以通过在分隔行中添加 : 来控制列的对齐方式。

代码示例

1
2
3
4
5
| 左对齐 (默认) | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 苹果 | 红色 | 5.00 |
| 香蕉 | 黄色 | 3.50 |
| 葡萄 | 紫色 | 8.20 |

效果演示

左对齐 (默认) 居中对齐 右对齐
苹果 红色 5.00
香蕉 黄色 3.50
葡萄 紫色 8.20

分隔线 (Horizontal Rules)

使用三个或更多的 ---、*** 或 ___ 来创建分隔线。

代码示例

1
2
3
---
***
___

效果演示

任务列表 (Task Lists)

这是一种扩展语法，常用于 GitHub 等平台，用于创建待办事项列表。

代码示例

1
2
3
- [x] 完成 Markdown 语法学习
- [ ] 练习编写文档
- [ ] 将文档发布到博客

效果演示

  • 完成 Markdown 语法学习
  • 练习编写文档
  • 将文档发布到博客

转义字符 (Escaping Characters)

如果你需要显示 Markdown 中用于格式化的字符（如 *、_、# 等），可以在其前面加上反斜杠 \ 进行转义。

代码示例

1
2
\* 这不会变成斜体，而是显示星号 \*
\# 这不会变成标题，而是显示井号

效果演示

* 这不会变成斜体，而是显示星号 *
# 这不会变成标题，而是显示井号

结语

恭喜你！你已经掌握了 Markdown 的绝大部分核心语法。现在，你可以开始使用 Markdown 来撰写博客、笔记、文档或任何其他文本内容了。它的简洁和强大一定会让你的写作效率倍增!