Markdown基础教程|KOMON狐狸窝

开始之前

本文改编自https://blog.csdn.net/qq_40818172/article/details/126260661

Markdown是一种文本标记语言。相对于超文本标记语言Html，它更加易学以及易写。目前已广泛用于各种blog网站，以及github这种代码托管网站。本网站也同样使用了Markdown来发布文章。
当你希望在本网站使用Markdown写文章，请将编辑器切换为ByteMD或者Vditor Markdown

正文

标题

标题用井号表示。一个井号为一级标题，两个为二级标题，以此类推到六级。然后井号后面要跟空格再输入标题文本。

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

字体

主要是斜体，以及加粗

*这是斜体*
_这是斜体_
**这是粗体**
__这是粗体__
***这是粗斜体***
___这是粗斜体___

效果

这是斜体
这是斜体
这是粗体
这是粗体
这是粗斜体
这是粗斜体

换行

换行方式如下：

直接在一句话后敲两个空格
两句话之间加一个空行
如果你在编辑的时候，想让一行文字在显示的时候换行，就在中间加 <br/>

引用

引用会在前面加灰色竖条，并且引用字符也会变淡。

> 1级引用
>> 2级引用
>>> 3级引用

效果如下

1级引用

2级引用

3级引用

链接

链接有两种

<https://www.komonmc.cn>                //第一种链接名和连接相同
[KOMON狐狸窝](https://www.komonmc.cn)   //第二种先用方括号括起名称，然后圆括号写链接

效果如下：
https://www.komonmc.cn
KOMON狐狸窝

插入图片

![KOMON狐狸窝](/upload/icon.png)
//方括号内写入图片描述，圆括号内写入URL链接，或者在本机的地址
//如果想更换调整图片推荐使用html中的<img>标签
<img src="/upload/icon.png" width = 100 height = 100>

因为图片大小原因，这里没使用markdown语法实现
这里用的是html的 <img>标签

列表

列表分为有序列表和无序列表，和html的列表差不多，但是语法更加简洁

无序列表用 +,*,-后接一个空格代表
有序列表用 1.,2.后接空格代表
示例如下：

- 无序列表
+ 无序列表
* 无序列表
1. 有序列表1
2. 有序列表2

效果：

无序列表

无序列表

无序列表

有序列表1

有序列表2

列表也可以有子列表

+ 无序列表
    + 无序列表 //前面按tab键
    + 无序列表
1. 有序列表1
    1. 有序列表1.1
2. 有序列表2

效果：

无序列表

无序列表

无序列表

有序列表1

有序列表1.1

有序列表2

分割线，删除线，下划线

分割线：

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

效果：

//注意：写分割线前，要空一行之后写，否则会导致前一行字体放大。

~~要删除的文字~~
<u>这行文字已被添加下划线</u>//此网站无法显示，因为容易和链接混淆

~~要删除的文字~~

代码

代码块有两种，一种是一小块的代码如 <img>还有上文的大段代码。
小段代码用两个反引号(`)括起
大段代码则使用三个反引号开头加语言名，末尾再加上三个反引号
如

//当然上面这个代码不是很正确，这是我改了以后的
#include<iostream>
int main(){
   cout<<"HelloWorld";
}

支持的语言：

bash
c，clojure，cpp，cs，css
dart，dockerfile, diff
erlang
go，gradle，groovy
haskell
java，javascript，json，julia
kotlin
lisp，lua
makefile，markdown，matlab
objectivec
perl，php，python
r，ruby，rust
scala，shell，sql，swift
tex，typescript
verilog，vhdl
xml
yaml

表格

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

:-：将表头及单元格内容左对齐
-:：将表头及单元格内容右对齐
:-:：将表头及单元格内容居中

| 代码       | 作用    | 示例  |
| --------   | -----:  | :----:  |
| `<img>`    |显示图片|`<img src="/upload/icon.png" width = 100 height = 100>`|

效果：

代码	作用	示例
`<img>`	显示图片	`<img src="/upload/icon.png" width = 100 height = 100>`

特殊符号

和c语言等差不多，markdown用到的符号只需要用\就可以正常显示了，懒得多讲了。

脚注

就是在文章末尾加上备注一样，类似于写参考文献的地方

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.

效果：
使用 Markdown¹可以效率的书写文档, 直接转换成 HTML², 你可以使用 Typora³ 编辑器进行书写。

注意：脚注自动被搬运到最后面，请到文章末尾查看，并且脚注后方的链接可以直接跳转回到加注的地方。

本文代码

因为```是代码块标记，所以里面用···代替,不保证代码和原文完全一样。

## 开始之前
>本文改编自<https://blog.csdn.net/qq_40818172/article/details/126260661>

Markdown是一种文本标记语言。相对于超文本标记语言Html，它更加易学以及易写。目前已广泛用于各种blog网站，以及github这种代码托管网站。本网站也同样使用了Markdown来发布文章。

## 正文

### 标题

标题用井号表示。一个井号为一级标题，两个为二级标题，以此类推到六级。然后井号后面要跟空格再输入标题文本。

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

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

### 字体

主要是斜体，以及加粗

···markdown
*这是斜体*
_这是斜体_
**这是粗体**
__这是粗体__
***这是粗斜体***
___这是粗斜体___
···

效果

> *这是斜体*
> _这是斜体_
> **这是粗体**
> __这是粗体__
> ***这是粗斜体***
> ___这是粗斜体___

### 换行

换行方式如下：

+ 直接在一句话后敲两个空格
+ 两句话之间加一个空行
+ 如果你在编辑的时候，想让一行文字在显示的时候换行，就在中间加 `<br/>`

### 引用

引用会在前面加灰色竖条，并且引用字符也会变淡。

···markdown
> 1级引用
>> 2级引用
>>> 3级引用
···

效果如下

> 1级引用
>
>> 2级引用
>>
>>> 3级引用
>>>
>>

### 链接

链接有两种

····markdown
<https://www.komonmc.cn>                //第一种链接名和连接相同
[KOMON狐狸窝](https://www.komonmc.cn)   //第二种先用方括号括起名称，然后圆括号写链接
···

效果如下：
[https://www.komonmc.cn](https://www.komonmc.cn)
[KOMON狐狸窝](https://www.komonmc.cn)

### 插入图片

···markdown
![KOMON狐狸窝](/upload/icon.png)
//方括号内写入图片描述，圆括号内写入URL链接，或者在本机的地址
//如果想更换调整图片推荐使用html中的<img>标签
<img src="/upload/icon.png" width = 100 height = 100>
···

因为图片大小原因，这里没使用markdown语法实现
这里用的是html的 `<img>`标签

> <img src="/upload/icon.png" width = 100 height = 100>

### 列表

列表分为有序列表和无序列表，和html的列表差不多，但是语法更加简洁

+ 无序列表用 `+`,`*`,`-`后接一个空格代表
+ 有序列表用 `1.`,`2.`后接空格代表
  示例如下：

···markdown
- 无序列表
+ 无序列表
* 无序列表
1. 有序列表1
2. 有序列表2
···

效果：

> - 无序列表
>
> + 无序列表
>
> * 无序列表
>
> 1. 有序列表1
> 2. 有序列表2

列表也可以有子列表

···markdown
+ 无序列表
    + 无序列表 //前面按tab键
    + 无序列表
1. 有序列表1
    1. 有序列表1.1
2. 有序列表2
···

效果：

> + 无序列表
>   + 无序列表
>   + 无序列表
>
> 1. 有序列表1
>    1. 有序列表1.1
> 2. 有序列表2

### 分割线，删除线，下划线

···markdown
分割线：

---
***
- - -
* * *
···

效果：

>---
>***
>- - -
>* * *
>
> //注意：写分割线前，要空一行之后写，否则会导致前一行字体放大。

···markdown
~~要删除的文字~~
<u>这行文字已被添加下划线</u>//此网站无法显示，因为容易和链接混淆
···

~~要删除的文字~~

### 代码

代码块有两种，一种是一小块的代码如 `<img>`还有上文的大段代码。
小段代码用两个反引号(\`)括起
大段代码则使用三个反引号开头加语言名，末尾再加上三个反引号
如


![e9dec8f5aa0743968a84c1d075b77b90.png](/upload/e9dec8f5aa0743968a84c1d075b77b90.png)
···cpp
//当然上面这个代码不是很正确，这是我改了以后的
#include<iostream>
int main(){
   cout<<"HelloWorld";
}
···
支持的语言：
···markdown
bash
c，clojure，cpp，cs，css
dart，dockerfile, diff
erlang
go，gradle，groovy
haskell
java，javascript，json，julia
kotlin
lisp，lua
makefile，markdown，matlab
objectivec
perl，php，python
r，ruby，rust
scala，shell，sql，swift
tex，typescript
verilog，vhdl
xml
yaml
···
### 表格
表格使用`|`来分割不同的单元格，使用`-`来分隔表头和其他行

+ `:-`：将表头及单元格内容左对齐
+ `-:`：将表头及单元格内容右对齐
+ `:-:`：将表头及单元格内容居中
···markdown
| 代码       | 作用    | 示例  |
| --------   | -----:  | :----:  |
| `<img>`    |显示图片|`<img src="/upload/icon.png" width = 100 height = 100>`|
···
效果：
| 代码       | 作用    | 示例  |
| --------   | -----:  | :----:  |
| `<img>`    |显示图片|`<img src="/upload/icon.png" width = 100 height = 100>`|
### 特殊符号
和c语言等差不多，markdown用到的符号只需要用`\`就可以正常显示了，懒得多讲了。
### 脚注
就是在文章末尾加上备注一样，类似于写参考文献的地方
···markdown
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.
···
效果：
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.

>注意：脚注自动被搬运到最后面，请到文章末尾查看，并且脚注后方的链接可以直接跳转回到加注的地方。

## 本文代码
···markdown
//本文代码
···