Markdown学习文档

最新推荐文章于 2023-11-23 14:10:47 发布

qyj980825

最新推荐文章于 2023-11-23 14:10:47 发布

阅读量173

点赞数 2

分类专栏： markdown 文章标签： markdown

本文链接：https://blog.csdn.net/qyj980825/article/details/112344090

版权

markdown 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

MarkDown

前言

什么是MarkDown

Markdown是一种轻量级标记语言，它以纯文本形式(易读、易写、易更改)编写文档。

通常使用的.doc或.txt。.doc文档过于臃肿，且使用者需要过多的在乎格式的书写，而不是文档内容；.txt文档过于简陋，只能进行简单的文字编写，无法进行图片插入的操作。

因此，Aaron Swartz和John Gruber共同设计了Markdown标记语言，文档的后缀为.md。这类文件，简言之，即建立在txt的基础上、通过简单的符号语法使其能够满足格式的显示、同时也能够进行图片插入、列表、流程图制作等操作的轻量级文本书写工具。

Markdown的优势

易读易写易修改，轻量级，极简主义的思想
兼容HTML，能够转换为HTML格式发布
跨平台

语法

1.多级标题

两种形式：

使用 = 和 - 标记一级二级标题
```
一级标题
=========
二级标题
---------
```
效果：

一级标题

二级标题
使用 # 能显示 1-6 级标题(注意符号和文字之间有空格)
```
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
```
效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 段落

段落的前后要有空行，所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车（引用中换行省略回车）。

3.区块

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用，如：(注意符号和数字之间有空格)

> 区块引用
>> 嵌套引用
>> **可使用别的标记语法**

效果：

区块应用

嵌套应用

可使用别的标记语法

4.代码区块

使用 ```[代码格式]可形成一个代码区块，能够更加清晰的展现代码(关键字颜色)

```c
#include <stdio.h>
int main(int argc, const char *argv[])
{
	return 0;
}

效果：

#include <stdio.h>
int main(int argc, const char *argv[])
{
	return 0;
}

5.强调字体

在强调内容两侧分别加上*或者_，如：

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

效果：

斜体，斜体
粗体，粗体

6.列表

无序列表

使用·、+、或-标记无序列表，如：(注意符号和文字之间有空格)

- (+*) 第一项
- (+*) 第二项
- (+*) 第三项

效果：

第一项
第二项
第三项

有序列表

有序列表的标记方式是将上述的符号换成数字,并辅以.，如：(注意符号和文字之间有空格)

1 . 第一项
2 . 第二项
3 . 第三项

效果：

第一项
第二项
第三项

7.分割线

分割线最常使用就是三个或以上*，还可以使用-和_。

---(回车)

效果：

8.链接

行内式链接

格式：

[**](link "description")

效果：

baidu

参考式链接

格式：

[**][a]

words...
...

[a]:link "description"

效果：

baidu

word…

…

9.图片插入

添加图片的形式和链接相似，只需在链接的基础上前方加一个！

![图片名称](link)

效果：

在这里插入图片描述

10.反斜杠

因为标识符是Markdown语法的主体，所以要想表示标识符，要在标识符前加上\

\\ \- \` \'

效果：

\ - ` ’

11.行内代码

使用 ``将行内的代码包住，从而起到标记作用

我定义了一个变量` int a  `

效果：

我定义了一个变量 int a

12.表格

绘制一张表格，–：右对齐，：-- 左对齐：， — 为表头和表项的分隔符

| name | id | salary |
|------|---:|:-------|
|xiaoming| 1 | 10000 |
|xiaohong| 2 | 20000 |

效果：

name	id	salary
xiaoming	1	10000
xiaohong	2	20000

13.删除线

用~~ ~~包住的文字

~~1 error(s), 1 warning(s)~~

效果：

~~1 error(s), 1 warning(s)~~

14.UML图

序列图

```mermaid
sequenceDiagram
up->>reader: 一键三连了嘛
Note right of reader: thinking...
reader->>up: 下次一定
```

效果：

流程图

```mermaid
flowchat
st=>start: begin
end=>end: end
NO=>operation: 下次一定
YES=>operation: 白嫖失败
cond=>condition: 一键三连

st->cond
cond(yes)->YES
cond(no)->NO
YES->end
NO->end

```

效果：