Markdown 语法手册

Markdown 简介

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(John Gruber)创建。
Markdown 的设计哲学是可读性。
Markdown 支持原生 HTML 标签.
vscode侧边预览markdown的插件：markdown-preview-echanced¹
附：官网²、中文指南³、菜鸟教程⁴
——2023.04.21，@ivcc admin

Markdown 语法手册

1 标题

使用 # 来定义标题,一共有 1-6 级标题。语法:

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

另一种语法：

一级标题
=================
二级标题
-----------------

2 段落、换行与分割线

段落是多个相关句子组成,使用空行分隔不同的段落。
换行在句末输入两个或更多空格然后回车。
使用三个或更多的星号(*)、减号(-)、底线(_)来创建一条分隔线

***
---
_________________

3 字体

（1）语法：

*斜体*
_斜体_

**粗体**
__粗体__

***粗斜体***
___粗斜体___

~~删除线~~

下划线

（2）使用 HTML 的 标签可以设置字体颜色文本:

• color_name 为颜色名称或 RGB 值
• 支持的颜色名称包括:red、blue、green、yellow 等
• RGB 值使用格式 #RGB 或 #RRGGBB

浅红色文字 

浅红色文字 浅绿色文字 浅蓝色文字 浅紫色文字

4 引用与脚注

使用 > 来定义块引用:

> 引用 

使用多个 > 来实现嵌套引用:

> 引用
>> 嵌套引用

脚注语法：

iv创客官网 [^1]。

[^1]: www.ivcc.cc

5 列表

使用 *,+ 或 - 来定义无序列表:

* 项目一 
* 项目二
* 项目三

使用数字加 . 来定义有序列表:

1. 项目一 
2. 项目二 
3. 项目三

列表嵌套只需要在子列表项前添加四个空格：

1. 项目一 
    - 项目1
    - 项目2
    - 项目3
2. 项目二 
3. 项目三

6 代码

行内代码单个或多个反引号```````连续包裹内容：

`abc`

代码块使用三个或以上反引号换行包括内容,开头的三个反引号后面可以跟上语言名称：

```python
import os
list1 = os.listdir()
print(list1)
```            -

代码区块也可以使用 4 个空格或者一个制表符（Tab 键）

7 图片

(1) 使用 ![alt](src "title") 来定义图片:

• alt:图像无法显示时的替代文本,用于提高可访问性。
• src:图像的URL地址,用于显示图像。
• title:鼠标悬停时显示的提示文本,可选。

![flower](flower.jpg)
![flower](flower.jpg "花的图片")

(2) 使用{: style="..."}的方式内联添加样式

![flower](flower.jpg){: style="float:right; margin:0 0 0 10px; width:30%"}

(3) 可以在 标签中直接添加 HTML 属性来设置图片尺寸和布局:

• 第一个图像指定了200像素的固定宽高
• 第二个图像使用样式float:right和margin来实现右对齐,并指定了30%的宽度
• 第三个图像使用了align="middle"来居中显示(Markdown也支持已废弃的HTML属性)

8 链接

使用 [alt](src "title") 来定义链接:

• alt:链接描述。
• src:链接地址。

[iv创客官网](https://www.ivcc.cc)

使用 <> 定义链接,尖括号内为链接地址(此方式没有描述，直接显示链接地址）:

说明：Markdown本身语法不支持链接在新页面打开，可以用html语言的a标签代替：
链接描述

9 表格

（1）使用 | 来定义表格,使用 - 来分割 表头和单元格:

| 栏目1  |  栏目2 |     栏目3 |
| :-: | :-: | :-: |
| 单元格1| 单元格2| 单元格3|

• :-: 居中对齐
• :- 左对齐
• -: 右对齐

（2）单元格中可以结合字体语法、行内代码语法使用
（3）高级语法

• 跨行和跨列
• 嵌套表格

---

1. Markdown Preview Enhanced：https://shd101wyy.github.io/markdown-preview-enhanced/#/zh-cn/， 是一款为 Atom 以及 Visual Studio Code 编辑器编写的超级强大的 Markdown 插件。 这款插件意在让你拥有飘逸的 Markdown 写作体验。 ↩︎

2. 官网:https://daringfireball.net/projects/markdown/ ↩︎

3. 中文指南:https://www.markdown.xyz/ ↩︎

4. 菜鸟教程:https://www.runoob.com/markdown/md-tutorial.html ↩︎