Markdown 基础

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档


如果希望深入了解 Markdown 的高级功能(如扩展语法、插件等),可以查阅 CommonMarkGitHub Flavored Markdown (GFM) 的官方文档。


标题

使用 # 来创建标题,最多支持六级标题。

markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落与换行

段落之间空一行即可。若想在段落内换行,可以在行尾添加两个空格或一个反斜杠 \

markdown
这是一个段落。  
这是第二行,使用两个空格实现换行。  
这是第三行。

这是另一个段落。

显示效果:

这是一个段落。
这是第二行,使用两个空格实现换行。
这是第三行。

这是另一个段落。


强调文字

  • 加粗:使用双星号 ** 或双下划线 __
  • 斜体:使用单星号 * 或单下划线 _
  • 删除线:使用两个波浪线 ~~
markdown
**加粗文字** 或 __加粗文字__

*斜体文字*_斜体文字_

~~删除线文字~~

显示效果:

加粗文字加粗文字
斜体文字斜体文字
删除线文字


有序/无序列表

无序列表

使用 -*+ 开头:

markdown
- 项目一
- 项目二
  - 子项目
- 项目三

显示效果:

  • 项目一
  • 项目二
    • 子项目
  • 项目三

有序列表

使用数字加点:

markdown
1. 第一步
2. 第二步
3. 第三步

显示效果:

  1. 第一步
  2. 第二步
  3. 第三步

链接与图片

超链接

markdown
[Google](https://www.google.com)

显示效果:

Google


图片

markdown
![描述文字](https://images.unsplash.com/photo-1477005264461-b0e201668d92?w=400&h=200&fit=crop)

显示效果:

描述文字


代码块

行内代码

使用反引号 ` 包裹:

markdown
这是一个 `代码片段`

显示效果:

这是一个 代码片段


多行代码块

使用三个反引号 ``` 并指定语言类型:

markdown
```python
def hello():
    print("Hello, world!")
text

显示效果:

```python
def hello():
    print("Hello, world!")

引用

使用 > 来创建引用:

markdown
> 这是一个引用段落。
>
> 它可以跨多行。

显示效果:

这是一个引用段落。

它可以跨多行。


表格

使用竖线 | 和连字符 - 创建表格,并可选地对齐方式:

markdown
| 姓名     | 年龄 | 性别 |
|----------|------|------|
| 张三     | 25   | 男   |
| 李四     | 30   | 女   |

显示效果:

姓名 年龄 性别
张三 25
李四 30

分隔线

使用三个以上的 -*_ 创建水平线:

markdown
---

显示效果: