markdown学习
2022年12月6日
Markdown的官网:https://markdown.com.cn/basic-syntax/
公式参考链接:http://t.csdn.cn/kjbPr
0. 准备工作
我使用的是VSCode来进行markdown编辑
需要下载的插件
- markdown all in one
- markdown preview enhanced
- paste image
实现预览需要右击在命令面板中输入:Markdown: Open Preview to the Side
1. 标题等级
在文字前加 ‘#’ ,
一级标题加1个#
二级标题加2个#,即 ## hello ##
以此类推,总共支持六级标题
注意:一般为了规范,会在标题结束加上对应数量的#,不加也行
2. 段落格式
2.1 段落的换行
- 在段落末尾加上2个以上的空格,再输入回车
- 在段落后使用一个空行,表示重新开一个段落
2.2 粗体和斜体
- 用1个*包围要斜体的内容,例如: 斜体
- 用2个*包围要加粗的内容,例如: 粗体
- 用3个*包围,就是加粗且倾斜,例如: 加粗倾斜
2.3 分隔线
在一行中使用三个***,单独成行
下面是一条分割线:
2.4 删除线
使用 ~ 包围文字
删除
2.5 下划线
使用来包围需要加下划线的内容
<u> 下划线 </u>
3. 列表
3.1 无序列表
使用-、+、*都可以生成无序列表(前面带小圆点的内容)
- 无序列表1
- 无序列表2
- 无序列表3
3.2 有序列表
使用数字后面加小数点,生成有序列表
- 有序列表1
- 有序列表2
- 有序列表3
3.3 列表嵌套
有序列表和无序列表可以嵌套使用
- 有序1
- 有序1中的无序1
- 有序1中的无序2
- 有序2
- 有序2中的无序1
- 有序2中的无序2
4. 区块
在行首加 > 可以实现区块,区块可以配合列表使用
- 列表1
列表1中的区块
- 列表2
列表2中的区块
5.代码
用 ```包裹一段代码,并指定一种语言(也可以不指定)
这个`在键盘的左上角,波浪线的下面(不是中文的顿号)
printf("hello world\n");
printf("This my markdown learning\n");
6. 链接
- 隐藏链接地址,将链接赋给文字
[百度链接](http://baidu.com)
- 直接给出链接地址
<http://baidu.com>
7.表格
Markdown使用 | 来区分不同单元格,使用-来区分表头和普通单元格,
格式如下:
|表头1|表头2|表头3|
|----|----|----|
|单元格|单元格|单元格|
|单元格|单元格|单元格|
表头1 表头2 表头3 单元格 单元格 单元格 单元格 单元格 单元格
- 注意:在markdown中打印关键字需要使用反斜杠,和C语言中很相似
比如-开头代表无序列表,打印- 可以使用 \-
8.公式
-
Markdown Preview Enhanced使用KaTex来渲染数学公式
- 行内公式:使用一个$包围,如 \(sin(0) = 0\)
- 单行公式:两个$包围
\[sin(0) = 0 \] -
上标
使用^,若上标的内容不止一个字符,需要用花括号{}包围(这是latex语法)\[y = F^{-1}(x) \] -
下标
使用下划线_\[x_i , i = 1,2,3,4 \]
9. 插入图片
Markdown插入图片的语法![alt text](图片链接 "图片title")
- 方括号里面的叫替代文本,图片title是可选项
- 常用的做法是建一个
images
文件夹,然后将图片存放到该文件夹中,使用相对路径进行引用
10. 画图
可以使用mermaid代码段绘制流程图等示意图
参考链接:
10.1 流程图(graph)
<!-- TB表示从上到下 , LR表示从左到右-->
graph TB;
节点类型
- 默认节点* A
- 文本节点 B[bname]
- 圆角节点 C(cname)
- 圆形节点 D((dname))
- 菱形节点 F
连线类型
连线间可以插入文字,作为说明
- 箭头连接 A1-->B1
- 开放连接 A2--B2
- 标签连接 A3--text--B3
- 箭头标签连接 A4–text–>B4
- 虚线开放连接 A5.-B5
- 虚线箭头连接 A6-.->B6
- 标签虚线连接 A7-.text.-B7
- 标签虚线箭头连接 A8-.text.->B8