Markdown学习笔记

峰-ZHANG

已于 2023-05-03 12:00:34 修改

阅读量185

点赞数 1

文章标签：学习笔记

于 2023-04-29 13:32:28 首次发布

本文链接：https://blog.csdn.net/qq_41907886/article/details/129056454

版权

概述

Markdown实际上和wps，word之类的没有多大区别，都是一种写文本的工具。初学的话，我建议直接跟的我下面的内容上手敲一遍，就能使用Markdown去创作自己的内容了。第一步不需要去下什么编辑器，直接进入csdn的界面，在界面的右上角，点击“发布”就进入了csdn配好的Markdown编辑器。如果以后csdn的页面布局变了，进入“创作中心”，然后把鼠标移动到“发布”上，点击文章，就进入了csdn给你配好的Markdown编辑器。
进入Markdown编辑器后直接在左侧输入内容，右侧就会出现显示效果。敲出我下面的实例就可以。
这篇文章我会在每个实例紧随的黑色代码框内，写出我是在Markdown编辑器中写了什么来达到实例的效果的。跟着敲一边就可以了。

标题

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

有6级标题，有几个#就是几级标题。

如果想要像我上面一样显示标题的目录，只需要在写入下面的代码

@[toc](标题目录)

文本样式

强调文本/斜体

*强调文本/斜体*

强调文本/斜体

_强调文本/斜体_

加粗文本

**加粗文本**

加粗文本

__加粗文本__

标记文本

==标记文本==

~~删除线~~

~~删除线~~

下划线

<u>下划线</u>

引用文本
更新：1小时前 / 第三十二章觉醒
立即阅读放入书架全本订阅
6059
月票
54904
推荐票
247140次
打赏
1271
刀片

要结束引用文本直接两个回车换行

>引用文本
>更新：1小时前 / 第三十二章 成功男人身后的女人们
>立即阅读 放入书架 全本订阅
>6059
>月票
>54904
>推荐票
>247140次
>打赏
>1271
>刀片

下标：我_下标，H₂O

我~下标~ ，H~2~O

上标：我^上标 ,2¹⁰

我^上标^ ,2^10^

组合使用：粗斜体，粗斜体

***粗斜体***，*__粗斜体__*

区块引用

就是上面内容，文本样式中的引用文本
区块引用中可以使用列表
列表中也可以使用区块

区块引用效果

区块引用嵌套效果谢谢

上面回车下来，再输入一个回车，就推出了上面的嵌套

> 区块引用效果
>
> > 区块引用嵌套效果谢谢
>
> 上面回车下来，再输入一个回车，就推出了上面的嵌套

代码块

单行代码

使用方法是代码块内容前面一个“反引号”，后面一个“反引号”。

效果： printf

`printf`

代码块
效果：

int main()
{
    printf("hello world\n");
    return 0;
}

实现方式:

```c
int main()
{
    printf("hello world\n");
    return 0;
}
//```在这里本来应该只有三个反引号```但是我没有办法直接写出来，所以用//```来代替

链接

链接：link

[link](https://www.baidu.com)

图片

插入图片时我是在CSDN的创作中心写的文章，只需要点击最上面一列的图片按钮就可以了。如果你用的是其他编辑器，插入网络上的图片，需要下面的格式：

图片的描述: ![Alt](https://img-home.csdnimg.cn/images/20220524100510.png)

如果你想插入计算机上的本地图片，我建议你和我一样直接使用CSDN写草稿时，上面的图片按钮。如果你用的是其他编辑器，需要根据你的编辑器去配置相关的图床。我这里有一个Typora配置图床的教学视频
在这里插入图片描述

列表

无序列表

列表1
- 子列表只需另起一行，输入两个空格，然后再写星号（*）就可以了
- 子列表
列表2

* 列表1
  * 子列表只需另起一行，输入两个空格，然后再写星号（*）就可以了
  * 子列表
* 列表2

有序列表

列表1
1.1 子列表只需另起一行然后输入前面的序号，再输入内容就可以了
列表2
列表3

1. 列表1
  1.1 子列表只需另起一行然后输入前面的序号，再输入内容就可以了
2. 列表2
3. 列表3

自定义列表
自定义列表中的“:”必须要用英文格式。

Markdown

Text-to-HTML conversion tool

Authors

John

Luke

Markdown
:  Text-to-HTML conversion tool

Authors
:  John
:  Luke

计划任务

计划任务
完成任务

- [ ]  计划任务
- [x] 完成任务

表格

表头	表头
文本居中	文本居中

|  表头  |  表头  |
| :----: | :----: |
| 文本居中 | 文本居中 |
|        |        |
|        |        |

表头	表头
文本居左	文本居右

|  表头  |表头|
| :----| ----: |
| 文本居左 | 文本居右 |
|        |        |
|        |        |

项目	value
电脑	￥7500
手机	￥6500

项目 | value
------- | -----
电脑|￥7500
手机|￥6500

注脚

我们需要用到内容¹
内容²

我们需要用到内容[^注脚1]
内容[^2]
[^注脚1]: 注脚1的解释内容，预览时会在文档的尾部。
[^2]: 注脚的名称没有什么用处，在预览时，csdn只会显示1,2,3

注释

注释的意思是指，将鼠标放在注释的内容上时，会显示出自己解释的意思。

例如：最后两个字就是注释的实例。

Markdown将文本转换为 HTL。

例如：最后两个字就是注释的 实例。

*[实例]:   这里就是我解释的实例的意思
  
Markdown将文本转换为 HTL。

*[HTL]:   超文本标记语言

注意：注释的内容，需要在它和前面的冒号之间放一个空格。

流程图（graph）

概述：

graph 方向描述
图表中的其他语句

关键字graph表示一个流程图的开始，同时需要指定该图的方向。
其中方向描述为：

用词	含义
TB	从上到下
BT	从下到上
RL	从右到左
LR	从左到右

T=TOP , B=BOTTOM , L=LEFT , R=RIGHT , D= DOWN

```mermaid
graph TB
A-->B-->C
B-->A
C-->A
//这里也是应该只写三个反引号```

```mermaid
graph LR
A----->B
B-->C
A-->C
//这里也是应该只写三个反引号```

流程图的节点形状

表述	说明	含义
id[文字]	矩形节点	表示过程，也就是整个流程中的一个环节
id(文字)	圆角矩形节点	表示开始和结束
id((文字))	圆形节点	表示连接。为避免流程过长或有交叉，可将流程切开。对开
id{文字}	菱形节点	表示判断。决策
id>文字]	右向旗帜状节点

单向箭头：表示流程进行的方向

id即为节点的唯一标识，A~F是当前节点名字，类似与变量名，画图是方便引用。
括号内是节点中要显示的文字，下面的例子中只写了一个A就默认节点的名字和显示的文字都为A
---->中短横线的个数越多，两个节点之间的连接线就越长。

```mermaid
graph TB
A
B[矩形节点]
C(圆角矩形节点)
D((圆形节点))
E{菱形节点}
F>右向旗帜状节点]
//这里也是应该只写三个反引号```

连线

```mermaid
graph TB
A1-->B1 
A2---B2
A3--text-->B3
A4--text---B4
A5-.-B5
A6-.->B6
A7-.text.-B7
A8-.text.->B8
A9===B9
A10==>B10
A11==text===B11
A12==text==>B12
//这里也是应该只写三个反引号```

子图表

subgraph 子图表名称
子图表中的描述语句
end

```mermaid 
graph LR 
subgraph  子表图名
a-->b
end
b-->c
//这里也是应该只写三个反引号```

序列图（sequence diagram）

概述

sequenceDiagram
[参与者1][参与者2][参与者3]:消息体
…

```mermaid
sequenceDiagram
Title:炸鸡店 
客户->>店员:我要一个炸鸡
店员-->>客户:做好了，给你
//这里也是应该只写三个反引号```

参与者（participant）

participant <声明参与者名> as 参与者
该语法下可以用声明参与者来代替参与者

```mermaid
sequenceDiagram
title:ss
participant a1 as 店员
participant a2 as 客户 
a2-->>a1 :我要一个炸鸡
//这里也是应该只写三个反引号```

消息线

类型	描述
->	无箭头的实线
–>	无箭头的虚线
->>	有箭头的实线（主动发出消息）
–>>	有箭头的虚线（响应）
-x	末端为叉的实线(表示异步)
–x	末端为叉的虚线(表示异步)

处理中-激活框

从消息接收方的时间线上标记一小段时间，表示对消息进行处理的时间间隔。
在消息线的末尾增加+号，则消息接收者进入当前消息的“处理中”状态。
在消息线的末尾增加-号，则消息接收者离开当前消息的“处理中”状态。

```mermaid
sequenceDiagram
title: 炸鸡店
participant 99 as  顾客
participant seller as 炸鸡店小哥
99 ->> seller:还有炸鸡吗？
seller -->>99:没有，要现炸 
99 -x +seller :给我炸
seller -->> -99:炸好了，给你
//这里也是应该只写三个反引号```

注解（note）

例子
语法如下：

Note 位置表述参与者：标注文字

参与者和符号：之间没有空格。

其中为是表述可以为：

表述	含义
right of	右侧
left of	左侧
over	在当中，可以横跨多个参与者

例子：

```mermaid
sequenceDiagram
title:炸鸡店
participant 99 as 顾客
participant seller as  炸鸡店小哥
Note  over  99,seller: 热爱炸鸡
Note left of 99: 女性
Note right of seller: 男性
99 ->> seller: 还有炸鸡吗
 seller -->>99: 没有了，要现炸
 99 -x +seller: 那炸一个吧
 seller -x -99: 炸好了，给您
 //这里也是应该只写三个反引号```

循环

在条件满足时，重复发出消息序列。（相当于编程语言中的while语句）

```mermaid
sequenceDiagram
participant 99 as 顾客
participant seller as 炸鸡店小哥

99 ->> seller: 给我一个炸鸡光临
seller -->>99:没有了要现炸
99 ->> +seller: 给我炸
 loop 三分种一次
     99 ->>seller: 好了吗？
     seller -->>99: 快了，稍等一下。
  end
 seller -->> -99: 您的炸鸡好了，给。
  //这里也是应该只写三个反引号```

选择alt

在多个条件中作出判断，每个条件将对应不同的消息序列。（相当于if 及else if 语句）

```mermaid
sequenceDiagram
participant 99 as 顾客
participant seller as 炸鸡点小哥
99 ->>seller: 现在有多少炸好的炸鸡？
seller -->>99: 炸好的炸鸡数
   alt 可卖的炸鸡数 > 3
       99 ->>seller: 买三只
   else 1<可卖的炸鸡数<3
      99 ->>seller: 全给我吧
   else 可卖的炸鸡数<1
       99 ->> seller: 那我明天再来吧。
   end

seller ->>99: 欢迎下次光临。
 //这里也是应该只写三个反引号```

可选（opt）

在某条件满足时执行消息序列，否者不执行。相当于单个分支的if语句。

```mermaid
sequenceDiagram
participant 99 as 顾客
participant seller as 炸鸡店小哥
99 ->>seller: 买炸鸡
opt 全都卖完了
    seller -->>99: 下次再来
end
 //这里也是应该只写三个反引号```

并行（par）

将消息序列分成多个片段，这些片段并行执行。

```mermaid
sequenceDiagram
participant 99 as 顾客
participant seller as 炸鸡店小哥
99 ->>seller: 一只炸鸡，一杯可乐
par 并行执行
    seller ->>seller:装炸鸡
    seller ->>seller:倒可乐
end
seller-->>99:您点的餐好了
 //这里也是应该只写三个反引号```

饼图（Pie）

```mermaid
pie
"A":8954
"B":3418
"C":9013
 //这里也是应该只写三个反引号```

甘特图（gantt）

语法格式

gantt
title 标题
dateFormat 日期格式
section 部分名
任务名：参数一，参数二，参数三，参数四，参数五

//参数一：crit（是否重要，红框框）或者不填
//参数二：done（已完成，灰色框框），active（正在进行，浅紫色框框）或者不填（表示为待完成状态，深紫色框框）
//参数三：取小名或者不填
//参数四：任务开始时间
//参数五：任务结束时间

甘特图举例

```mermaid
gantt
title 甘特图标题，下图表示左侧每个人的任务完成情况
dateFormat YYYY-MM-DD

section 员工1
完成的任务 : done, des1,2100-01-06,2100-01-08
正在进行的任务:active,des2,2100-01-09,3d
未来的任务1:des3,after des2,5d
未来的任务2:des4,after des3,3d

section 员工2
完成的任务 : crit,done, des1,2100-01-06,24h
完成的任务:crit,done,1d
正在进行的任务:crit,active,,2100-01-08,2d
未来的任务1:crit,5d
未来的任务2:1d
 //这里也是应该只写三个反引号```