<center>Markdown学习笔记</center>
一、环境配置
1. 平台下载
Markdown是一种轻量级标记语言,用于简单、易读易写的文本格式化
目前已经有多种平台支持Markdown,这里考虑使用Typora进行markdown语法编辑
下载官网 > Typora 官方中文站 (typoraio.cn)
通过官网可以直接下载最新版本的Typora;
2. Markdown编辑配置
打开Typora,点击文件->偏好设置->Markdown后按如下要求配置
3. 破解Typora
破解Typora参考博客 > Typora激活使用指南(2023年最新版) - 知乎 (zhihu.com)
亲测有效
二、Markdown语法学习
(1)常用语法
1. 标题
共有6中标题,即为一到六级标题,代码如下
<span style="background-color:#f8f8f8"><span style="color:#333333"><strong><span style="color:#0000ff"># 一级标题</span></strong>
<strong><span style="color:#0000ff">## 二级标题</span></strong>
<strong><span style="color:#0000ff">### 三级标题</span></strong>
<strong><span style="color:#0000ff">#### 四级标题</span></strong>
<strong><span style="color:#0000ff">##### 五级标题</span></strong>
<strong><span style="color:#0000ff">###### 六级标题</span></strong>
(#+空格)</span></span>
2. 字体效果
加粗
<span style="background-color:#f8f8f8"><span style="color:#333333"><strong>**加粗**</strong></span></span>
斜体
<span style="background-color:#f8f8f8"><span style="color:#333333"><em>*斜体*</em></span></span>
删除线
<span style="background-color:#f8f8f8"><span style="color:#333333"><s>~~删除线~~</s></span></span>
高亮
<span style="background-color:#f8f8f8"><span style="color:#333333">==高亮==</span></span>
3. 上下标
上下标可以用于公式的编写
上标
<span style="background-color:#f8f8f8"><span style="color:#333333">H~2~O</span></span>
下标
<span style="background-color:#f8f8f8"><span style="color:#333333">X^2^</span></span>
效果展示:酒精(CH5OH)、数学公式(y=x2)
4. 引用
引用1
引用2
引用3
可以进行多层嵌套
<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#221199">> </span><span style="color:#221199">引用1</span>
<span style="color:#116644">>> </span><span style="color:#116644">引用2</span>
<span style="color:#221199">>>> </span><span style="color:#221199">引用3</span></span></span>
5. 图片插入
<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#117700">![此处写图片名称]</span><span style="color:#aa1111">(此处加入图片的地址)</span>
<u><span style="color:#0000cc">[//]:</span></u> <span style="color:#aa1111">如下:</span>
<span style="color:#117700">![百度]</span><span style="color:#aa1111">(https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)</span></span></span>
图片插入不用直接下载图片,只需要加入图片的地址即可调用,显示效果如下
6. 链接
<span style="background-color:#f8f8f8"><span style="color:#333333"><u><span style="color:#0000cc">[此处设置链接名称]</span></u><span style="color:#aa1111">(此处加上链接地址)</span>
<u><span style="color:#0000cc">[//]:</span></u> <span style="color:#aa1111">如下</span>
<u><span style="color:#0000cc">[百度]</span></u><span style="color:#aa1111">(https://www.baidu.com/)</span></span></span>
用此语法后可直接显示百度名称的超链接,ctrl+点击后即可跳转,效果如下
7. 列表
无序列表
<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#0055aa">+ </span><span style="color:#0055aa">1</span>
<span style="color:#0055aa">* </span><span style="color:#0055aa">2</span>
<span style="color:#0055aa">- </span><span style="color:#0055aa">3</span>
<span style="color:#0055aa">- </span><span style="color:#0055aa">4</span>
<span style="color:#0055aa">+ </span><span style="color:#0055aa">5</span>
<span style="color:#0055aa">* </span><span style="color:#0055aa">6</span>
<u><span style="color:#0000cc">[//]:</span></u> <span style="color:#aa1111">(+、*、-</span> 任意符号+空格,嵌套在前面加一个tab)</span></span>
效果
-
1
-
2
-
3
-
4
-
5
-
6
-
-
-
有序列表
<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#0055aa">1. </span>
<span style="color:#0055aa">2. </span>
<span style="color:#0055aa">3. </span>
<u><span style="color:#0000cc">[//]:</span></u> <span style="color:#aa1111">数字+.+空格</span></span></span>
效果
8. 选择框
<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#0055aa">- </span><span style="color:#000000">[x] </span><span style="color:#0055aa">1</span>
<span style="color:#0055aa">- </span><span style="color:#555555">[ ] </span><span style="color:#0055aa">2</span>
<span style="color:#0055aa">- </span><span style="color:#555555">[ ] </span><span style="color:#0055aa">3</span>
<u><span style="color:#0000cc">[//]:</span></u> <span style="color:#aa1111">(可以进行点击选择,代码中的空格不可忽视,在[]内部输入x,则会默认勾选上)</span></span></span>
显示效果
- 1
- 2
- 3
9. 代码和代码块
单行代码(键盘左上角的反引号,两个`号间就可加入单行代码)
单行代码
代码块
<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#aa5500">``` 代码语言</span>
如下
<span style="color:#aa5500">``` markdown</span></span></span>
10. 目录(效果在本文开头)
<span style="background-color:#f8f8f8"><span style="color:#333333">[TOC]</span></span>
11. 分割线
———或***
效果:
12. 注释
[//]: 注释文字
(2)进阶学习
1. 数学公式
<span style="background-color:#f8f8f8"><span style="color:#333333"><span style="color:#aa5500">$$</span>
<span style="color:#aa5500">\frac</span><span style="color:#999977">{</span>partial f<span style="color:#999977">}{</span><span style="color:#117700">\partial</span> x<span style="color:#999977">}</span>=2<span style="color:#117700">\sqrt</span><span style="color:#999977">{</span>a<span style="color:#999977">}</span>x\*<span style="color:#117700">\alpha</span>
<span style="color:#aa5500">$$</span></span></span>
效果
\frac{partial f}{\partial x}=2\sqrt{a}x*\alpha
$$
【Tools】Markdown数学符号&公式(史上最全公式表)
2. 表格
<span style="background-color:#f8f8f8"><span style="color:#333333"><strong><span style="color:#0000ff">#### User表</span></strong>
|ID|姓名|年龄|身份证号码|手机号码|性别|
|:---|---:|:---:|---|---|---| [//]: :---表示左靠齐,---:表示向右靠齐,:---:表示居中
|1|张三|18|110\*\*\*\*\*\*\*\*\*\*\*0123|138\*\*\*\*0123|女|
|2|李四|23|210\*\*\*\*\*\*\*\*\*\*\*0135|138\*\*\*\*0132|男|
|2|王五|17|120\*\*\*\*\*\*\*\*\*\*\*0126|138\*\*\*\*0121|女|
</span></span>
效果
ID | 姓名 | 年龄 | 身份证号码 | 手机号码 | 性别 |
---|---|---|---|---|---|
1 | 张三 | 18 | 110***********0123 | 138****0123 | 女 |
2 | 李四 | 23 | 210***********0135 | 138****0132 | 男 |
2 | 王五 | 17 | 120***********0126 | 138****0121 | 女 |
使用 <font>
的标签的修改文字前景色
红色 绿色 蓝色
使用 rgb 颜色值
使用十六进制颜色值
18 Markdown 代码高亮_Markdown 入门教程-慕课网 (imooc.com)
3. 特殊符号
在 Markdown 文件中,在特殊符号前面使用「反斜杠 \
」,可以实现特殊符号转义,以便将特殊符号输出到文本中。
当要打出算式2*3*4=24
时候不能直接打出,而是要在*
号前加上反斜杠符号2\*3\*4=24
效果:2*3*4=24
Markdown提供以下特殊字符的转移支持
特殊符号 | 中文名称 | 默认语法 |
---|---|---|
\ | 反斜杠 | 转义符号,需要与其他特殊符号连用 |
` | 反引号 | 用于定义行内代码、代码块 |
* | 星号 | 用于定义无序列表、强调、分割线 |
_ | 下划线 | 用于定义强调、分割线 |
{} | 大括号 | 用于定义公式 |
[] | 中括号 | 用于定义超链接、图片 |
() | 小括号 | 用于定义超链接、图片 |
# | 井号 | 用于定义标题、粗体字 |
+ | 加号 | 用于定义无序列表、分割线 |
- | 减号 | 用于定义无序列表、分割线 |
. | 点号 | 用于定义有序列表 |
! | 叹号 | 用于定义超链接、图片 |
4. 流程图
流程图由几何图形节点及连接线组成。几何图形节点是流程图内的各元素的载体,通常用形状来区分其属性,例如圆形代表开始或结束、菱形代表判断等。连接线用于描述几何图形节点之间的联系,可能是有向线段,也可能是无向线段等。
在 Markdown 中添加 Mermaid 图形,需要声明 Mermaid 类型的代码块,代码如下:
<span style="background-color:#f8f8f8"><span style="color:#333333">```mermaid
<!-- 此处的内容会被渲染成 mermaid 图形 -->
```</span></span>
标志 | 方向 |
---|---|
TB | top bottom - 从上到下 |
BT | bottom top - 从下到上 |
RL | right left - 从右到左 |
LR | left right - 从左到右 |
TD | 等同于 TB |
各种图形语法参考> Markdown 流程图
演示代码
<span style="background-color:#f8f8f8"><span style="color:#333333">```mermaid
graph LR
执行1[i = 1]
执行2[j = 0]
执行3[i ++]
执行4["a = arr[j], b = arr[j + 1]"]
执行5[交换 a, b]
执行6[j ++]
判断1["i < n"]
判断2["j < n - i"]
判断3["a > b"]
开始 --> 执行1
执行1 --> 判断1
判断1 --Y--> 执行2
执行2 --> 判断2
判断2 --Y--> 执行4
判断2 --N--> 执行3
执行3 --> 判断1
执行4 --> 判断3
判断3 --N--> 判断2
判断3 --Y--> 执行5
执行5 --> 执行6
执行6 --> 判断2
判断1 --N--> 结束</span></span>
<span style="background-color:#f8f8f8"><span style="color:#333333">
```mermaid
graph LR
执行1[i = 1]
执行2[j = 0]
执行3[i ++]
执行4["a = arr[j], b = arr[j + 1]"]
执行5[交换 a, b]
执行6[j ++]
判断1["i < n"]
判断2["j < n - i"]
判断3["a > b"]
开始 --> 执行1
执行1 --> 判断1
判断1 --Y--> 执行2
执行2 --> 判断2
判断2 --Y--> 执行4
判断2 --N--> 执行3
执行3 --> 判断1
执行4 --> 判断3
判断3 --N--> 判断2
判断3 --Y--> 执行5
执行5 --> 执行6
执行6 --> 判断2
判断1 --N--> 结束</span></span>
5.时序图
绘制时序图,必须包含时序图类型声明、对象及消息三个部分。
基本时序图
<span style="background-color:#f8f8f8"><span style="color:#333333">```mermaid
sequenceDiagram
李雷->>韩梅梅: Hi LiLei, How do you do?
韩梅梅-->>李雷: How do you do!
```</span></span>
时序图中的消息是对参与者之间通信的时机与内容的描述,其声明方式如:[发起者][连线类型][接收者]:消息内容
。
其中连接类型有如下几种形式:
类型 | 描述 |
---|---|
-> | 没有箭头的实线 |
–> | 没有箭头的虚线 |
->> | 有箭头的实线 |
–>> | 有箭头的虚线 |
-x | 有交叉箭头的实线 |
–x | 有交叉箭头的虚线 |
更多效果参考> 22 Markdown 时序图_
6.类图
类是类图中的核心组成,类的成员包括属性和方法,以及一些扩展信息。在类图中,一个类实例由三层组成:
-
类名称,在类图的最顶端;
-
类属性,在类图的中间层;
-
类方法,在类图的最下层。
类图中「类」之间的逻辑关系由连接线表示,定义的形式如:[类A][箭头][类B]:标签文字
。
不同的逻辑关系定义如下:
Type | Description |
---|---|
<|-- | 继承关系 |
*-- | 组成关系 |
o-- | 集合关系 |
--> | 关联关系 |
-- | 实现连接 |
..> | 依赖关系 |
..|> | 实现关系 |
.. | 虚线连接 |
更多资料参考>23 Markdown 类图
7.状态图
状态代表某一对象在某一特定的条件、时间下所保持的静态值。
使用 Mermaid 扩展绘制状态图时,有多种方式声明一个状态节点。
通过设置状态 ID 声明状态
更多资料参考> 24 Markdown 状态图
8.甘特图
基本的甘特图由「标题」、「日期格式约定」、「分组及任务」三部分组成。
完整的甘特图实例
<span style="background-color:#f8f8f8"><span style="color:#333333">```mermaid
gantt
dateFormat :YYYY-MM-DD
title :甘特图实例
section 基本任务
已完成任务 :done, des1, 2014-01-06,2014-01-08
进行中任务 :active, des2, 2014-01-09, 3d
未开始任务1 : des3, after des2, 5d
未开始任务2 : des4, after des3, 5d
section 紧急任务
已完成的紧急任务 :crit, done, 2014-01-06,24h
已完成紧急任务1 :crit, done, after des1, 2d
进行中紧急任务2 :crit, active, 3d
未开始紧急任务3 :crit, 5d
未开始一般任务4 :2d
未开始一般任务5 :1d
section 文档编写
进行中文档任务1 :active, a1, after des1, 3d
未开始文档任务2 :after a1 , 20h
未开始文档任务3 :doc1, after a1 , 48h
section 其他部分
其他任务1 :after doc1, 3d
其他任务2 :20h
其他任务3 :48h
```</span></span>
更多资料参考>25 Markdown 甘特图
9.饼图
饼图的定义包含「标题」、「内容名称」和「内容权重」三项,其中「内容权重」会在渲染时,自动转换为百分比并显示在饼图上。
<span style="background-color:#f8f8f8"><span style="color:#333333">```mermaid
pie title 宠物的选择
"狗" : 386
"猫" : 85
"兔子" : 15
```</span></span>
10.脚注
脚注一般可以用于编写参考文献
要增加脚注(尾注),首先需要在文章的适当位置增加引用的描述,形如:[^引用ID]: 说明文字
。
实例 1:
脚注的声明。
<span style="background-color:#f8f8f8"><span style="color:#333333">[^footnote]: 此处是 **脚注** 的 *文本内容*。
代码块1</span></span>
注意,此步完成后,不会有渲染的内容输出,必须将引用添加到内容中才有显示。
实例 2:
完整的脚注。
<span style="background-color:#f8f8f8"><span style="color:#333333">这里有一个脚注[^1]。
这里有一个脚注[^2]。
[^1]: 此处是 **脚注** 的 *文本内容*。
[^2]: 此处是 **脚注** 的 *文本内容*。</span></span>
效果如下:
这里有一个脚注1。
这里有一个脚注2。
三、学习总结
Markdown语言是一种简洁、易读易写的轻量级标记语言,用于格式化文本,并且适用于各种文本编辑器和平台。
Markdown语言的学习和使用具有以下优势:
-
简洁:Markdown语法简单明了,使用少量特定字符即可实现各种文本格式和排版效果,避免了繁琐的HTML标记。
-
易读易写:Markdown语法类似于普通文本,可读性高,在任何文本编辑器中都可以直接编辑和查看。
-
平台适用性强:Markdown语言相对来说是跨平台的,可在不同操作系统和各种文本编辑器中使用。
学习了Markdown语言,并使用Markdown语言编写了实验报告。总的来说,通过学习Markdown语言并应用于实验报告的撰写中,我们可以更好地组织和展示实验结果和观察,并提高报告的可读性和可理解性。通过这次学习,我已能够熟练掌握Markdown语言的基本语法,为以后的报告撰写和文本排版提供方便。