Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。

Markdown 操作简单,仅需学习几分钟即可快速上手。在不同环境下,Markdown的显示方式可能不同。

以下是 Markdown 的基本语法。


标题

在想要设置标题的文本前加上#来表示。

一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

效果:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

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

字体

加粗

要加粗的文字左右分别用两个星号(**)包起来

斜体

要倾斜的文字左右分别用一个星号(*)包起来

斜体加粗

要倾斜和加粗的文字左右分别用三个星号(***)包起来

删除线

要加删除线的文字左右分别用两个~~号包起来

星号可用下划线(_)代替

**这是加粗的文字**
__这是加粗的文字__
*这是倾斜的文字*
_这是倾斜的文字_
***这是斜体加粗的文字***
___这是斜体加粗的文字___
__组合*内容*文字__
~~这是加删除线的文字~~

效果:

这是加粗的文字

这是加粗的文字

这是倾斜的文字

这是倾斜的文字

这是斜体加粗的文字

这是斜体加粗的文字

组合内容文字

这是加删除线的文字


引用

在需要引用的文字前加上 > 即可。

引用可以嵌套,例如加两个 >>,加三个 >>>,等等。

> 这是引用的内容
>> 这是引用的内容
>>> 这是引用的内容

效果:

这是引用的内容

这是引用的内容

这是引用的内容


分割线

使用连续的三个以上的*或-都可以。

---
----
***
*****

效果:





可以看到,效果都是一样的。


图片

语法:

![图片alt](图片地址 "图片title")

图片alt 是显示在图片下面的文字,相当于对图片内容的解释。
图片title 图片的标题,当鼠标移到图片上时显示的内容。title是可选的

示例:

![加载中](https://gzassets.cn/guizhan/image/preloader.gif "正在加载")

效果:

加载中


超链接

语法:

[显示的内容](超链接地址 "超链接title")

超链接title 与图片title作用相同,是鼠标移到超链接上时显示的内容。title是可选的

示例:

[百度](https://www.baidu.com "前往百度")
[Google](https://www.google.com "前往Google")

效果:

百度
Google

注意: Markdown 本身不支持超链接在新窗口打开,本站对链接做了处理,会在新窗口打开。如果需要在新窗口打开的链接,可以使用html的a标签实现。


列表

无序列表

在列表内容前加上 + - * 中的一种

* 无序列表
* 无序列表
* 无序列表
* 无序列表
* 无序列表

效果:

  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表

注意: 符号与内容之间需要有一个空格

有序列表

在列表内容前加上 数字与.

1. 有序列表
2. 有序列表
3. 有序列表
4. 有序列表

效果:

  1. 有序列表
  2. 有序列表
  3. 有序列表
  4. 有序列表

注意: 序号与内容之间需要有一个空格

列表嵌套

上一级与下一级列表之间相差3个空格

  • 无序列表

    • 无序列表
    • 无序列表
  • 无序列表

    • 无序列表
    • 无序列表
  1. 有序列表

    1. 有序列表
    2. 有序列表
  2. 有序列表

    1. 有序列表
    2. 有序列表

表格

语法:

|表头|表头|表头|
|---|:--:|---:|
|内容|内容|内容|
|内容|内容|内容|

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右

示例:

|姓名|成绩|排名|
|--|:--:|--:|
|张三|89|2|
|李四|92|1|
|王五|83|3|

效果:

姓名成绩排名
张三892
李四921
王五833

代码

单行代码

两边用反引号包起来。反引号键位于键盘上tab键的上方,数字1的左侧。

`print("Hello world!")`

效果:

print("Hello world!")

多行代码/代码块

使用三个反引号

(```)python
def add(a = 1, b = 2):
    return a + b

print(add(4, 5))
(```)

注意: 这里为了防止转义, 给三个反引号加上了括号。实际使用时,不需要加括号。

这里的 python 是为了说明这是 Python 语言的代码,在渲染时会按照Python的语法进行处理。

效果:

def add(a = 1, b = 2):
    return a + b

print(add(4, 5))