Markdown 语法全面教程

Markdown 语法全面教程

欢迎来到 Markdown 语法全面教程！本教程旨在详细介绍 Markdown 的所有常用语法，帮助您快速掌握 Markdown 的使用。

1. 标题 (Headers)

Markdown 支持六级标题，通过在行首添加 # 符号来表示。# 的数量代表标题的级别。

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

渲染效果:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

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

2. 段落 (Paragraphs)

段落由一个或多个连续的文本行组成，它们之间由一个或多个空行分隔。

1
2
3
4
5
这是一个段落。

这是另一个段落。
段落内的文本可以自动换行，
但只有当有空行时才会形成新的段落。

渲染效果:

这是一个段落。

这是另一个段落。
段落内的文本可以自动换行，
但只有当有空行时才会形成新的段落。

3. 强调 (Emphasis)

Markdown 提供了粗体、斜体和删除线等强调文本的方式。

斜体 (Italic)

使用一个星号 * 或一个下划线 _ 包裹文本。

1
2
*这是斜体文本*
_这也是斜体文本_

渲染效果:

这是斜体文本
这也是斜体文本

粗体 (Bold)

使用两个星号 ** 或两个下划线 __ 包裹文本。

1
2
**这是粗体文本**
__这也是粗体文本__

渲染效果:

这是粗体文本
这也是粗体文本

粗斜体 (Bold and Italic)

使用三个星号 *** 或三个下划线 ___ 包裹文本。

1
2
***这是粗斜体文本***
___这也是粗斜体文本___

渲染效果:

这是粗斜体文本
这也是粗斜体文本

删除线 (Strikethrough)

使用两个波浪线 ~~ 包裹文本。

1
~~这是删除线文本~~

渲染效果:

这是删除线文本

4. 列表 (Lists)

Markdown 支持无序列表、有序列表和任务列表。

无序列表 (Unordered Lists)

使用星号 *、加号 + 或减号 - 作为列表标记。

1
2
3
4
5
6
* 项目一
* 项目二
  * 子项目二-一
  * 子项目二-二
+ 项目三
- 项目四

渲染效果:

  • 项目一
  • 项目二
    • 子项目二-一
    • 子项目二-二
  • 项目三
  • 项目四

有序列表 (Ordered Lists)

使用数字后跟一个点 . 来创建有序列表。

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

渲染效果:

  1. 第一个项目
  2. 第二个项目
    1. 第二个项目的子项目一
    2. 第二个项目的子项目二
  3. 第三个项目

任务列表 (Task Lists)

在列表项前添加 [ ] 或 [x] 来创建任务列表。

1
2
3
- [x] 已完成任务
- [ ] 未完成任务
- [x] 另一个已完成任务

渲染效果:

  • 已完成任务
  • 未完成任务
  • 另一个已完成任务

Markdown 支持行内式链接和参考式链接。

[链接文本](链接地址 "可选标题")

1
[访问百度](https://www.baidu.com "百度一下")

渲染效果:

访问百度

[链接文本][id]
[id]: 链接地址 "可选标题"

1
2
3
4
5
这是一个 [示例链接][1]。
另一个 [谷歌][google] 链接。

[1]: https://example.com "示例网站"
[google]: https://www.google.com "谷歌搜索"

渲染效果:

这是一个 [示例链接]。
另一个 [谷歌][google] 链接。

: https://example.com “示例网站”
[google]: https://www.google.com “谷歌搜索”

6. 图片 (Images)

图片语法类似于链接，只是在前面多了一个感叹号 !。

行内式图片 (Inline Images)

![alt 文本](图片地址 "可选标题")

1
![Markdown Logo](https://markdown.com.cn/assets/img/favicon.png "Markdown 标志")

渲染效果:

Markdown Logo

参考式图片 (Reference Images)

![alt 文本][id]
[id]: 图片地址 "可选标题"

1
2
3
![示例图片][img_id]

[img_id]: https://via.placeholder.com/150 "占位符图片"

渲染效果:

示例图片

7. 代码 (Code)

Markdown 支持行内代码和代码块。

行内代码 (Inline Code)

使用反引号 ` 包裹文本。

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

渲染效果:

这是一个 行内代码 示例。

代码块 (Code Blocks)

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

1
2
3
```python
def hello_world():
    print("Hello, Markdown Code Block!")
1
2
const message = "Hello, JavaScript!";
console.log(message);
1
2
3
4
5
6

**渲染效果:**

```python
def hello_world():
    print("Hello, Markdown Code Block!")
1
2
const message = "Hello, JavaScript!";
console.log(message);

8. 引用 (Blockquotes)

使用 > 符号来创建引用块。

1
2
3
4
5
6
> 这是一个引用块。
> 引用块可以包含多行文本。
>
> > 引用块中还可以嵌套引用块。
>
> 引用块也可以包含其他 Markdown 语法，例如 **粗体** 和 [链接](https://example.com)。

渲染效果:

这是一个引用块。
引用块可以包含多行文本。

引用块中还可以嵌套引用块。

引用块也可以包含其他 Markdown 语法，例如 粗体 和 链接。

9. 水平线 (Horizontal Rules)

使用三个或更多星号 ***、减号 --- 或下划线 ___ 来创建水平线。

1
2
3
4
5
***

---

___

渲染效果:

10. 表格 (Tables)

使用 | 分隔列，使用 --- 分隔表头和表体。

1
2
3
4
5
| 表头一 | 表头二 | 表头三 |
| :----- | :----: | -----: |
| 左对齐 |  居中  | 右对齐 |
| 内容 A | 内容 B | 内容 C |
| 内容 D | 内容 E | 内容 F |

渲染效果:

表头一 表头二 表头三
左对齐 居中 右对齐
内容 A 内容 B 内容 C
内容 D 内容 E 内容 F

对齐方式：

  • :-----：左对齐
  • :----:：居中对齐
  • -----:：右对齐

11. 注释 (Comments)

Markdown 本身没有官方的注释语法。但您可以使用 HTML 注释来在 Markdown 文件中添加注释，这些注释在渲染时不会显示。

1
2
3
4
<!-- 这是一个 HTML 注释，在渲染时不会显示 -->

这是一个正常的段落。
<!-- 另一个注释 -->

渲染效果:

这是一个正常的段落。

12. 反斜杠转义 (Backslash Escapes)

如果您想显示 Markdown 语法字符本身，而不是让它们被解析，可以使用反斜杠 \ 进行转义。

1
2
3
\*这不是斜体\*
\# 这不是标题
\`这不是代码\`

渲染效果:

*这不是斜体*
# 这不是标题
`这不是代码`

Markdown 会自动将 URL 和邮箱地址转换为链接，如果它们被尖括号 < > 包裹。

1
2
<https://www.example.com>
<mailto:test@example.com>

渲染效果:

https://www.example.com
mailto:test@example.com

希望这份全面的 Markdown 教程对您有所帮助！