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）语法：

*斜体*
_斜体_**粗体**
__粗体__***粗斜体***
___粗斜体___~~删除线~~<u>下划线</u>

（2）使用 HTML 的 标签可以设置字体颜色<font color='color_name'>文本</font>:

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

<font color="#dd0000">浅红色文字 </font>

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

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) 可以在 <img> 标签中直接添加 HTML 属性来设置图片尺寸和布局:

<img src="flower.jpg" width="200" height="200" alt="flower">
<img src="flower.jpg" width="30%" style="float:right; margin:0 0 0 10px;"> 
<img align="middle" src="flower.jpg" >

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

8 链接

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

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

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

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

<https://www.ivcc.cc>

说明：Markdown本身语法不支持链接在新页面打开，可以用html语言的a标签代替：
<a href="链接地址" target="_blank">链接描述</a>

9 表格

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

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

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

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

• 跨行和跨列
• 嵌套表格