Markdown学习笔记

最新推荐文章于 2024-08-19 17:13:46 发布

John先生36

最新推荐文章于 2024-08-19 17:13:46 发布

阅读量808

点赞数 22

文章标签：学习笔记

本文链接：https://blog.csdn.net/qq_62299574/article/details/135434624

版权

<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>

效果

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>

显示效果

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>

李雷韩梅梅Hi LiLei, How do you do?How do you do!李雷韩梅梅

时序图中的消息是对参与者之间通信的时机与内容的描述，其声明方式如：[发起者][连线类型][接收者]:消息内容。

其中连接类型有如下几种形式：

类型	描述
->	没有箭头的实线
–>	没有箭头的虚线
->>	有箭头的实线
–>>	有箭头的虚线
-x	有交叉箭头的实线
–x	有交叉箭头的虚线

更多效果参考> 22 Markdown 时序图_

6.类图

类是类图中的核心组成，类的成员包括属性和方法，以及一些扩展信息。在类图中，一个类实例由三层组成：

类名称，在类图的最顶端；
类属性，在类图的中间层；
类方法，在类图的最下层。

动物

String 标签

吃()

类图中「类」之间的逻辑关系由连接线表示，定义的形式如：[类A][箭头][类B]:标签文字。

不同的逻辑关系定义如下：

Type	Description
`<\|--`	继承关系
`*--`	组成关系
`o--`	集合关系
`-->`	关联关系
`--`	实现连接
`..>`	依赖关系
`..\|>`	实现关系
`..`	虚线连接

更多资料参考>23 Markdown 类图

7.状态图

状态代表某一对象在某一特定的条件、时间下所保持的静态值。

使用 Mermaid 扩展绘制状态图时，有多种方式声明一个状态节点。

通过设置状态 ID 声明状态

状态1

状态描述性文字

状态3的文字描述

更多资料参考> 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>

2014-01-072014-01-092014-01-112014-01-132014-01-152014-01-172014-01-192014-01-21已完成任务已完成的紧急任务已完成紧急任务1进行中文档任务1进行中紧急任务2进行中任务未开始文档任务2未开始文档任务3未开始紧急任务3其他任务1未开始任务1其他任务2其他任务3未开始一般任务4未开始任务2未开始一般任务5基本任务紧急任务文档编写其他部分:甘特图实例

更多资料参考>25 Markdown 甘特图

9.饼图

饼图的定义包含「标题」、「内容名称」和「内容权重」三项，其中「内容权重」会在渲染时，自动转换为百分比并显示在饼图上。

<span style="background-color:#f8f8f8"><span style="color:#333333">```mermaid
pie title 宠物的选择
    "狗" : 386
    "猫" : 85
    "兔子" : 15 
```</span></span>

79%17%3%宠物的选择狗猫兔子

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。

[1] 此处是脚注1 的 文本内容。

[2] 此处是脚注2 的 文本内容。

三、学习总结

Markdown语言是一种简洁、易读易写的轻量级标记语言，用于格式化文本，并且适用于各种文本编辑器和平台。

Markdown语言的学习和使用具有以下优势：

简洁：Markdown语法简单明了，使用少量特定字符即可实现各种文本格式和排版效果，避免了繁琐的HTML标记。
易读易写：Markdown语法类似于普通文本，可读性高，在任何文本编辑器中都可以直接编辑和查看。
平台适用性强：Markdown语言相对来说是跨平台的，可在不同操作系统和各种文本编辑器中使用。

学习了Markdown语言，并使用Markdown语言编写了实验报告。总的来说，通过学习Markdown语言并应用于实验报告的撰写中，我们可以更好地组织和展示实验结果和观察，并提高报告的可读性和可理解性。通过这次学习，我已能够熟练掌握Markdown语言的基本语法，为以后的报告撰写和文本排版提供方便。