Markdown基础

# 基础篇

# 一、标题

# 使用 `#` 号标记

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

1
2
3
4
5
6
7
8
9
10
11

显示效果如下:

# 一级标题

# 二级标题

# 三级标题

# 四级标题

# 五级标题

# 六级标题

# 二、文本

# 段落

Markdown 段落没有特殊的格式，直接编写文字就好，
段落的换行是使用两个以上空格加上回车。

直接两个回车是空行

Markdown 中段落开始的空格是无效的，想要实现可以利用 Markdown 支持 HTML 语法，使用 HTML 代码产生空格效果

中文段落首行空两格

&emsp;&emsp;中文段落首行空两格

Markdown

&ensp;&ensp;Markdown

# 字体

*斜体文本*
_斜体文本_

**粗体文本**
__粗体文本__

***粗斜体文本***
___粗斜体文本___

1
2
3
4
5
6
7
8

斜体文本
斜体文本

粗体文本
粗体文本

粗斜体文本
粗斜体文本

# 文字高亮

文字高亮使用反引号 ` 包裹

`高亮`的字体

高亮 的字体

# 删除线

添加删除线使用一对波浪线 ~~ 包裹

我是被删除的~~aaaa~~

我是被删除的~~aaaa~~

# 下划线

添加下划线可以通过 HTML 的  标签来实现

<u>带下划线的文本</u>

带下划线的文本

# 分隔线

在一行中用三个以上的星号*、减号-、底线_ 来建立一个分隔线，行内不能有其他东西, 但在符号中间可以插入空格

***
* * *

---
- - -

___
_ _ _

1
2
3
4
5
6
7
8

# 脚注

脚注是对文本的补充说明，Markdown 脚注的格式如下:

[^变量]
[^变量]: 注明的内容

1
2

创建脚注格式类似这样[^value] [^value]: 这是脚注的内容

# 三、列表

# 有序列表

有序列表使用数字并加上 . 号加空格来表示

1. 第一项
2. 第二项

1
2

第一项
第二项

# 无序列表

无序列表使用星号*、加号+、减号- 加上空格来表示

* 第一项 *
* 第二项 *

+ 第一项 +
+ 第二项 +

- 第一项 -
- 第二项 -

1
2
3
4
5
6
7
8

第一项 *
第二项 *

第一项 +
第二项 +

第一项 -
第二项 -

# 复选框列表

* [x] 第一项
* [ ] 第二项
* [ ] 第三项

1
2
3

[x] 第一项
[ ] 第二项
[ ] 第三项

注：在部分线上预览未支持

# 折叠列表

<details>
<summary>点我打开折叠</summary>
 折叠的内容
 <ul>
     <li>1</li>
     <li>2</li>
     <li>3</li>
 </ul>
</details>

1
2
3
4
5
6
7
8
9

点我打开折叠

折叠的内容

<details> 标签内写 markdown 代码无效，可写html代码，如ul>li、table等

# 列表嵌套

列表嵌套只需在子列表中的选项前面添加四个空格即可

1. 第1项
    - 第1.1项
    - 第1.2项
2. 第2项
    - 第2.1项
    - 第2.2项
        - 第2.2.1项

1
2
3
4
5
6
7

第1项
- 第1.1项
- 第1.2项
第2项
- 第2.1项
- 第2.2项
  - 第2.2.1项

# 四、区块

Markdown 区块引用是在开头使用 > 符号加一个空格符号

> 区块引用

区块引用
回车自动延长区块
两个回车取消

注：有些需要在后面加两空格再换行，就跟段落换行那样

# 区块嵌套

区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

1
2
3

最外层

第一层嵌套

第二层嵌套

# 区块中使用列表

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> - 111
> - 222

1
2
3
4
5

区块中使用列表

第一项

第二项

111

222

# 列表中使用区块

在列表项目内放进区块，需要在 > 前添加四个空格的缩进。

- 第一项
    > 区块引用
- 第二项
    > 1  
    > 2

1
2
3
4
5

第一项
区块引用
第二项
1
2

注：有些需要在 >1 后面加两空格再换行，就跟段落换行那样

# 五、代码块

用三个反引号 ``` 包裹一段代码，并指定一种语言（也可以不指定），指定代码语言后会有代码的颜色高亮

```js
function hello() {
	alert('hello')
}
```

1
2
3
4
5

function hello() {
	alert('hello')
}

1
2
3

代码块中显示包裹的标记符

上面第一个显示源码的源码，依次类推，多层就用多个 ` 对应包裹起来

````md
```js
function hello() {
	alert('hello')
}
```
````

1
2
3
4
5
6
7

# 六、链接

# 基本格式

格式1：

[链接名称](链接地址) 
[百度](http://www.baidu.com,'百度')

1
2

百度 (opens new window)

格式2：

<链接地址>
<http://www.baidu.com>

1
2

http://www.baidu.com (opens new window)

# 变量链接

链接可以用变量来代替，文档末尾或其他位置附带变量地址

这个链接用 baidu 作为网址变量 [百度][baidu]

然后在文档的结尾或其他位置给变量赋值
[baidu]: http://www.baidu.com/

1
2
3
4

这个链接用 baidu 作为网址变量百度 (opens new window)

# 相对链接

可使用相对链接来跳转到对应文件（确保该路径下文件存在）
[Markdown 介绍篇](01.介绍.md)

1
2

Markdown 介绍篇

# 锚点链接

markdown 文件中每一个标题都是一个锚点，和HTML的锚点（#）类似

[代码块](#五、代码块)

前往代码块

注意：github对含有标点符号的标题进行锚点时会忽略掉标点符号
本例中，如果这样写则无法跳转：[代码块](#五、代码块)
正确写法：[代码块](#五代码块)

# 七、图片

和链接的区别是前面多一个感叹号 !

![alt 属性文本](图片链接地址)
![alt 属性文本](图片地址 "可选标题")
![md](https://cdn.staticaly.com/gh/foreverRuns/image-hosting@main/blog/markdown/md.5k7ogxwgm7ls.webp "Markdown图片")

1
2
3

当然，你也可以像链接那样对图片地址使用变量

这里链接用 md 作为图片地址变量
![markdown][md]
然后在文档的结尾或其他位置给变量赋值（图片地址）
[md]: https://cdn.staticaly.com/gh/foreverRuns/image-hosting@main/blog/markdown/md.5k7ogxwgm7ls.webp

1
2
3
4

![markdown][md] [md]: https://cdn.staticaly.com/gh/foreverRuns/image-hosting@main/blog/markdown/md.5k7ogxwgm7ls.webp

# 图片宽度高度

Markdown 支持html，设置图片宽高，可以直接使用 <img> 标签，通过CSS控制

<img src="https://cdn.staticaly.com/gh/foreverRuns/image-hosting@main/blog/bg-classroom.1kvh5rjqvccg.webp" width="400px" height="200px">

# 图片居中显示

<div align="center">
    <img src="https://cdn.staticaly.com/gh/foreverRuns/image-hosting@main/blog/markdown/md.5k7ogxwgm7ls.webp">
</div>

1
2
3

注：图片链接地址也是可以使用本地相对地址的

# 八、表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。

| 表头 | 表头 |
| --- | ---  |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

1
2
3
4

表头	表头
单元格	单元格
单元格	单元格

# 对齐方式

:- 设置内容和标题栏居左对齐
:-: 设置内容和标题栏居中对齐
-: 设置内容和标题栏居右对齐

| 表头 | 表头 | 表头 | 
| :--- | :---: | ---: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

1
2
3
4

表头	表头	表头
单元格	单元格	单元格
单元格	单元格	单元格

# 九、转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用反斜杠 \ 来转义字符

**未转义星号显示加粗**
\*\* 转义显示星号 \*\*

> [转义](#九、转义)  
> \[转义](#九、转义)

1
2
3
4
5

未转义星号显示加粗
** 转义显示星号 **

转义
[转义](#九、转义)

也可以用反引号来高亮显示原特殊符号

**未转义星号显示加粗**
`**未转义星号显示加粗**`

1
2

未转义星号显示加粗
**使用文字高亮也可以显示特殊符号**

# 十、HTML元素

不在 Markdown 语法涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有：<kbd>  等等，如：

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

<b>我是使用b标签的加粗字体</b>

1
2
3

使用 Ctrl+Alt+Del 重启电脑

我是使用b标签的加粗字体

编辑此页

#Markdown

上次更新: 2023/02/02, 14:58:40

← Markdown介绍 Markdown进阶→

Markdown基础

# 基础篇

# 一、标题

# 使用 # 号标记

# 一级标题

# 二级标题

# 三级标题

# 四级标题

# 五级标题

# 六级标题

# 二、文本

# 段落

# 字体

# 文字高亮

# 删除线

# 下划线

# 分隔线

# 脚注

# 三、列表

# 有序列表

# 无序列表

# 复选框列表

# 折叠列表

# 列表嵌套

# 四、区块

# 区块嵌套

# 区块中使用列表

# 列表中使用区块

# 五、代码块

# 六、链接

# 基本格式

# 变量链接

# 相对链接

# 锚点链接

# 七、图片

# 图片宽度高度

# 图片居中显示

# 八、表格

# 对齐方式

# 九、转义

# 十、HTML元素

# 使用 `#` 号标记