Skip to content
高琦程 Gao Qicheng
Go back

Markdown Notes

Edit page

Markdown 是一种轻量级标记语言,可以使用简单的符号编写格式清晰的文档。


1. 标题

Markdown 支持六级标题,在文字前添加 # 即可。


# 一级标题

## 二级标题

### 三级标题

建议在 # 和标题文字之间保留一个空格。


2. 换行

在一行末尾输入两个空格,然后按回车。


第一行末尾有两个空格。  

这是第二行。

3. 粗体、斜体和删除线

3.1 粗体


**这是粗体文字**

__这也是粗体文字__

显示效果:

这是粗体文字

3.2 斜体


*这是斜体文字*

_这也是斜体文字_

显示效果:

这是斜体文字

3.3 粗斜体


***这是粗斜体文字***



___这也是粗斜体文字___

显示效果:

这是粗斜体文字

4.4 删除线


~~这是被删除的文字~~

显示效果:

这是被删除的文字


4. 无序列表

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


- 苹果
- 香蕉
- 橙子

建议统一使用 -,方便保持文档风格一致。


5. 多级列表

通过缩进创建嵌套列表,通常使用两个或四个空格。


6. 任务列表

任务列表常用于待办事项。


- [x] 学习标题语法

- [x] 学习列表语法

- [ ] 学习表格语法

- [ ] 完成练习

其中:

- [x] 表示已经完成

- [ ] 表示尚未完成

任务列表属于扩展语法,GitHub、GitLab、Typora 等平台通常都支持。


7. 引用

使用 > 创建引用。


> 这是一段引用文字。

7.1 多行引用


> 这是引用的第一行。

>

> 这是引用的第二段。

7.2 嵌套引用


> 一级引用

>

>> 二级引用

>>

>>> 三级引用

8. 行内代码

使用一对反引号包裹代码。


使用 `print()` 函数输出内容。

显示效果:

使用 print() 函数输出内容。

如果内容本身包含反引号,可以使用两个反引号包裹:


``代码中包含 ` 反引号``

9. 代码块

使用三个反引号包裹多行代码。


```

这里是代码内容

这里是第二行代码

```

在开头的三个反引号后添加语言名称,可以启用语法高亮。


```python

def greet(name):

	print(f"Hello, {name}!")

greet("Markdown")

```

def greet(name):

	print(f"Hello, {name}!")

greet("Markdown")

10. 分隔线

使用三个或更多的 -、* 或 _ 创建分隔线。


---



***



___

为了避免与其他语法混淆,建议在分隔线前后各保留一个空行。


11. 超链接

11.1 普通链接


[OpenAI 官网](https://openai.com)

基本格式:


[链接文字](链接地址)

11.2 带提示文字的链接


[OpenAI 官网](https://openai.com "访问 OpenAI")

鼠标悬停在链接上时,可能会显示提示文字。


12. 图片

图片语法与链接类似,只是在前面增加一个感叹号 !。


![图片说明](https://example.com/image.png)

基本格式:


![替代文字](图片地址)

12.1 带提示文字的图片


![图片说明](https://example.com/image.png "图片标题")

12.2 使用本地图片

假设 Markdown 文件和 images 文件夹位于同一个目录:


![项目截图](./images/screenshot.png)

上一级目录中的图片:


![项目截图](../images/screenshot.png)

12.3 点击图片跳转

可以将图片语法放进链接语法中:


[![图片说明](https://example.com/image.png)](https://example.com)

13. 转义字符

当需要显示 Markdown 特殊符号本身时,可以在符号前添加反斜杠 \。

常见可转义字符:


\  反斜杠

`  反引号

*  星号

_  下划线

{} 花括号

[] 方括号

() 圆括号

#  井号

+  加号

-  减号

.  英文句点

!  感叹号

|  竖线

>  大于号

Edit page
Share this post:

Previous Post
Hello World!
Next Post
网站维护备忘