侧边栏壁纸
博主头像
KOMON狐狸窝 博主等级

用像素共创你我的世界

  • 累计撰写 6 篇文章
  • 累计创建 3 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录

Markdown基础教程

Tobby_000
2024-05-10 / 0 评论 / 0 点赞 / 145 阅读 / 0 字

开始之前

本文改编自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. 有序列表1
  2. 有序列表2

列表也可以有子列表

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

效果:

  • 无序列表
    • 无序列表

    • 无序列表

  1. 有序列表1
    1. 有序列表1.1
  2. 有序列表2

分割线,删除线,下划线

分割线:

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

效果:





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

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

要删除的文字

代码

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

e9dec8f5aa0743968a84c1d075b77b90.png

//当然上面这个代码不是很正确,这是我改了以后的
#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.

效果:
使用 Markdown1可以效率的书写文档, 直接转换成 HTML2, 你可以使用 Typora3 编辑器进行书写。

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

本文代码

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

## 开始之前
>本文改编自<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
//本文代码
···

Footnotes

  1. Markdown是一种纯文本标记语言

  2. HyperText Markup Language 超文本标记语言

  3. NEW WAY TO READ & WRITE MARKDOWN.

0
博主关闭了所有页面的评论