OpenHarmony开发者论坛

标题: MarkDown的语法详解 [打印本页]

作者: potato_princess 时间: 2024-12-28 18:39
标题: MarkDown的语法详解
[md]### 一、标题

Markdown支持1\~6级标题，使用 `#`号表示不同级别的标题，`#`号越多，标题级别越低。例如：

```markdown
markdown复制代码# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题
```

### 二、段落

Markdown段落没有特殊的格式，直接编写文字即可。段落的换行是使用两个以上空格加回车，或者使用空行进行分隔。

### 三、字体

Markdown支持多种字体样式，包括斜体、粗体、删除线等。

* **斜体**：使用单个 `*`或 `_`将文字包裹起来即可实现斜体效果。例如：`*斜体文本*` 或 `_斜体文本_`。
* **粗体**：使用两个 `**`或 `__`将文字包裹起来即可实现粗体效果。例如：`**粗体文本**` 或 `__粗体文本__`。
* **删除线**：使用两个 `~~`将文字包裹起来即可实现删除线效果。例如：`~~删除线文本~~`。

此外，Markdown还支持下划线（通过HTML标签 `<u>`实现）、下标（使用两个 `~`包裹文字）、上标（使用两个 `^`包裹文字）等字体样式。

### 四、列表

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

* **无序列表**：使用 `*`、`+`或 `-`作为列表的标记，这些标记后面要加一个空格。例如：

```markdown
markdown复制代码- 项目1- 项目2- 项目3
```

* **有序列表**：使用数字并加上 `.`表示。例如：

```markdown
markdown复制代码1. 项目12. 项目23. 项目3
```

Markdown还支持列表嵌套和勾选列表。列表嵌套只需要在子列表中的选项前面添加四个空格（或使用Tab键）即可。勾选列表使用 `[ ]`（未勾选）或 `[x]`（已勾选）来表示。

### 五、区块

Markdown区块引用是在段落开头使用 `>`符号，后面紧跟一个空格符号。区块引用可以让文字显得更加突出，并且支持嵌套。例如：

```markdown
markdown复制代码> 这是区块引用> > 这是嵌套区块引用
```

### 六、代码

Markdown支持代码高亮，如果是段落上的一个函数或片段的代码，可以用反引号（```）把它包裹起来。例如：`print('hello world')`。

如果需要展示一段代码，可以使用三个反引号（`````）包裹代码，并指定一种语言（也可以不指定）。例如：

```markdown
markdown复制代码```pythonimport requestsresp = requests.get(url='https://www.baidu.com')resp.encoding = 'utf-8'print(resp.text)```
```

### 七、链接和图片

* **链接**：Markdown链接的语法格式为 `[链接文字](链接地址 "标题")`。标题是可选项，鼠标经过链接文字时，会显示标题内容。Markdown还支持参考形式的链接，通过变量来设置一个链接，变量赋值在文档末尾进行。
* **图片**：Markdown图片的语法格式为 `![alt 属性文本](图片地址 "可选标题")`。开头一个叹号（!），接着一个方括号，里面放上图片代替文字，接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 `title`属性的文字。

### 八、表格

Markdown制作表格使用 `|`来分隔不同单元格，使用 `-`来分隔表头和其他行。例如：

```markdown
markdown复制代码| 表头1 | 表头2 ||-------|-------|| 单元格1 | 单元格2 |
```

Markdown还支持设置表格的对齐方式，通过在分隔符行中的短划线的左右两侧添加冒号（:）来实现。例如，左对齐使用 `:--`，右对齐使用 `--:`，居中对齐使用 `:--:`。

### 九、分隔线

Markdown分隔线可以使用三个及以上的 `*`、`-`或 `_`来表示，行内不能有其他东西。也可以在星号或是减号中间插入空格。例如：

```markdown
markdown复制代码***---_____
```

### 十、高级技巧

* **支持HTML元素**：Markdown支持在文档中直接使用HTML标签，以扩展Markdown的功能。
* **转义字符**：Markdown使用 `\`转义特殊字符。
* **数学公式**：Markdown支持使用Tex或LaTeX格式的数学公式，使用两个 `$`包裹公式即可实现行内公式，使用 `$$`+回车包裹公式即可实现行间公式。

### 十一、其他

* **待办事项列表**：Markdown支持待办事项列表，使用 `- [ ]`表示未完成的待办事项，使用 `- [x]`表示已完成的待办事项。
* **灰色底框**：Markdown支持使用反引号（```）来标记单行文本，或使用三个反引号（`````）来标记多行文本，以实现灰色底框效果。
[/md]

欢迎光临 OpenHarmony开发者论坛 (https://forums.openharmony.cn/)