Skip to content

Markdown 语法

Markdown 是一种轻量级的标记语言,用于格式化文档,深受开发者的喜爱,在开源项目中广泛用于编写 README 文件、问题评论、Pull Requests 描述等。

标题

使用 # 符号来创建标题,标题的级别由 # 的数量决定,最多支持六级标题。

markdown
# 这是一级标题

## 这是二级标题

### 这是三级标题

文本格式

粗体和斜体

使用 **__ 包围文本以创建粗体,使用 *_ 包围文本以创建斜体。

markdown
**这是粗体**_这是斜体_

引用

使用 > 符号创建引用块。

markdown
> 这是引用的文本。

行内代码

使用 ` 来包围文本以创建行内代码。

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

列表

无序列表

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

markdown
- 项目 1
- 项目 2
  - 子项目 2.1
  - 子项目 2.2

* 项目 3

有序列表

使用数字和点号创建有序列表。

markdown
1. 项目 1
2. 项目 2
   1. 子项目 2.1
   2. 子项目 2.2
3. 项目 3

嵌套列表

可以嵌套无序和有序列表。

链接

内部链接

可以使用 [链接文本](链接URL) 创建链接。

markdown
[GitCode](https://gitcode.com/)

外部链接

在文本中输入完整的 URL 或邮箱地址即可自动链接。

图片

使用 ![替代文本](图片URL) 插入图片。

markdown
![GitCode Logo](https://gitcode.com/assets/gitcode-logo-bf8686e9.png)

代码块

使用三个 ` 符号创建代码块,可以指定编程语言来进行语法高亮。

```python def hello_world(): print(“Hello, World!”) ```

表格

使用 |- 来创建表格,可以指定表格的对齐方式。

markdown
| 列 1   | 列 2   |
| ------ | ------ |
| 内容 1 | 内容 2 |

任务列表

使用 - [ ]- [x] 来创建任务列表。

markdown
- [ ] 未完成任务
- [x] 已完成任务

水平线

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

markdown
---

引用其他用户或问题

在文本中使用 @ 符号,可以引用其他用户或问题,他们将会收到通知。

markdown
@username 提到了你。

Emoji 表情

支持在文本中使用 Emoji 表情,例如 :smile: 会显示为 😄。

数学公式

使用两个美元符号 $$ 包围数学公式,可以呈现数学公式。

markdown
$$
E = mc^2
$$

UML 语法

UML 语法图是一种用于可视化、描述和设计软件系统的标准化图形表示方法。

markdown
@startuml
Alice -> "Bob()" : Hello
"Bob()" -> "This is very long" as Long
' You can also declare:
' "Bob()" -> Long as "This is very long"
Long --> "Bob()" : ok
@enduml

PlantUML 为创建和编辑序列图提供了一种简单明了、用户友好的方法,更多关于 UML 语法的使用帮助,可以参考 PlantUML 快速入门指南