Markdown 是一种轻量级的标记语言,用于格式化文本。它旨在易于阅读和编写,同时可以轻松转换为 HTML。下面列出一些常用的 Markdown 语法及其示例,每个示例都带有注释辅助理解。
标题
使用 #
符号来创建标题。#
的数量决定了标题的级别(1 到 6 级,飞书可到9级)。
# 一级标题 # 一个 `#` 表示一级标题
## 二级标题 ## 两个 `#` 表示二级标题
### 三级标题 ### 三个 `#` 表示三级标题
#### 四级标题 #### 四个 `#` 表示四级标题
##### 五级标题 ##### 五个 `#` 表示五级标题
###### 六级标题 ###### 六个 `#` 表示六级标题
段落和换行
段落是由一个或多个连续的文本行组成。要在段落之间插入换行,只需在行末添加两个空格或使用两个换行符。
这是一个段落。 # 一个段落
这是另一个段落。 # 另一个段落
这是第一行。
这是第二行。 # 使用两个空格换行
强调
使用星号 *
或下划线 _
来强调文本。
*斜体文本* # 使用星号表示斜体
_斜体文本_ # 使用下划线表示斜体
**粗体文本** # 使用双星号表示粗体
__粗体文本__ # 使用双下划线表示粗体
***粗斜体文本*** # 使用三颗星号表示粗斜体
___粗斜体文本___ # 使用三颗下划线表示粗斜体
列表
无序列表
使用星号 *
、加号 +
或减号 -
来创建无序列表。
* 项目1 # 使用星号表示无序列表项
* 项目2
* 项目3
+ 项目1 # 使用加号表示无序列表项
+ 项目2
+ 项目3
- 项目1 # 使用减号表示无序列表项
- 项目2
- 项目3
有序列表
使用数字和点来创建有序列表。
1. 第一项 # 使用数字和点表示有序列表项
2. 第二项
3. 第三项
链接
使用方括号 [ ]
和圆括号 ( )
来创建链接。
[这是一个链接](https://www.example.com) # 方括号内的文本是链接显示的文字,圆括号内的文本是链接地址
图片
使用感叹号 !
、方括号 [ ]
和圆括号 ( )
来插入图片。
 # 方括号内的文本是图片的替代文字,圆括号内的文本是图片的URL
代码
行内代码
使用反引号 `
来表示行内代码。
这是一个 `行内代码` 示例。 # 反引号内的文本表示行内代码
代码块
使用三个反引号 ``````来表示代码块。可以指定编程语言以启用语法高亮。
```python
def hello_world():
print("Hello, world!")
```# 三个反引号表示代码块
引用
使用大于号 >
来创建引用。
> 这是一个引用。 # 大于号表示引用
水平线
使用三个或更多个星号 *
、减号 -
或下划线 _
来创建水平线。
*** # 三个星号表示水平线
---
___
表格
使用管道 |
和破折号 -
来创建表格。
| 列1 | 列2 | 列3 |
| --- | --- | --- |
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
注释
Markdown 本身没有注释语法,但可以使用 HTML 注释来实现。
<!-- 这是一个注释 -->
综合示例
以下是一个综合示例,展示了多种 Markdown 语法的使用。
# 我的Markdown文档
## 介绍
这是一个使用Markdown语法编写的文档示例。
### 标题和段落
这是一个段落。
这是同一段落的第二行。
### 强调
*斜体文本*
**粗体文本**
***粗斜体文本***
### 列表
#### 无序列表
* 项目1
* 项目2
* 项目3
#### 有序列表
1. 第一项
2. 第二项
3. 第三项
### 链接和图片
这是一个 [链接](https://www.example.com)。

### 代码
这是一个 `行内代码` 示例。
```python
def hello_world():
print("Hello, world!")
引用
这是一个引用。
水平线
表格
列1 | 列2 | 列3 |
---|---|---|
数据1 | 数据2 | 数据3 |
数据4 | 数据5 | 数据6 |