与其临渊羡鱼,不如退而结网。
文章目录
前言
- 经济下行,行业竞争愈发激烈,同行间也越来越卷。只有不断地学习,提升自己的综合能力,才不会被淘汰,所以
提升学习效率
是非常重要的。 - 我们可以看官方文档、看B站视频,看书,但是总会看了就忘,忘了再看,总是记不住。只有对原理有深刻的理解,以及不断地重复记忆和实践,才能彻底掌握一门知识。
记笔记
是一个非常好的习惯,记笔记
不仅可以梳理自己的思路,并且可以在反复修改笔记的过程中,让我们注意到一些容易忽略的细节。与此同时,当我们忘记了某知识点时,我们可以随时翻看笔记,从而快速捡起那些被遗忘的知识点。记笔记
需要好的工具,可以借助一些在线网站或笔记软件,它们很多都支持Markdown
,本文档本着学习Markdown
的目的,跟大家一起分享下Markdown
的基本用法。
1、什么是Markdown?
答:Markdown 是一款轻量级标记语言,与HTML不同,它的语法非常简单;
2、为什么要使用Markdown?
1. Markdown非常简洁和精炼,对比其他工具,它可以让我们远离臃肿的功能,让我们回归内容本身;
2. Markdown以纯文本格式编写文档,依赖键盘而非鼠标,可以让我们专注于写作本身,而非文档格式;
3. Markdown是笔记与网页文章的最佳载体,市面上有很多支持MD的在线编辑网页和笔记软件。
注意:本文章中,Markdown
中用到的符号都是英文状态下的符号。
一、标题和目录
1.1 标题
标题:一个或多个#
+ 空格
+ 文本
- 注意事项:
一个#代表一级,最多支持六级标题,即 一级标题~六级标题。
- 示范写法:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 - 显示效果:
1.2 目录
目录:在文档的顶部输入[toc]
,会根据1.1所述的标题自动生成文章目录
- 注意事项:
并不是所有的MD编辑器都支持自动生成文章目录
- 示范写法: [toc]
- 显示效果:见本文档的文章目录
二、斜体与粗体
2.1 斜体
斜体写法一:*
+ 文本
+ *
- 示范写法:*这是斜体文本*
- 显示效果:这是斜体文本
斜体写法二:_
+ 文本
+ _
- 示范写法:_这也是斜体文本_
- 显示效果:这也是斜体文本
2.2 粗体
粗体写法一:**
+ 文本
+ **
- 示范写法:**这是粗体文本**
- 显示效果:这是粗体文本
粗体写法二:__
+ 文本
+ __
- 格式说明:
__
是由两个下划线_
组成的 - 示范写法:__这也是粗体文本__
- 显示效果:这也是粗体文本
2.3 粗斜体和斜粗体
粗斜体和斜粗体: 粗体和斜体相互嵌套,一共有六种
- 示范写法:
***粗斜体1***
**_粗斜体2_**
*__粗斜体3__*
___粗斜体4___
__*粗斜体5*__
_**粗斜体6**_ - 显示效果:
粗斜体1
粗斜体2
粗斜体3
粗斜体4
粗斜体5
粗斜体6
2.4 斜体中包含粗体
- 说明:
- 斜体中包含粗体,外面是斜体,里面是粗体,为嵌套关系
- 外面是斜体,标识符是一个;里面是粗体,标识符是两个
- 里面的粗体,符号不能是两个下划线
__
,否则没效果
- 格式一:
*
+文本
+**
+粗体文本
+**
+文本
+*
- 示范写法:*君不见**黄河之水**天上来*
- 显示效果:君不见黄河之水天上来
- 格式二:
_
+文本
+**
+粗体文本
+**
+文本
+_
- 示范写法:_君不见**黄河之水**天上来_
- 显示效果:君不见黄河之水天上来
2.5 粗体中包含斜体
- 说明:
- 粗体中包含斜体,外面是粗体,里面是斜体,为嵌套关系
- 外面是粗体,标识符是两个,里面是斜体,标识符是一个
- 里面的斜体,符号不能是一个下划线_
,否则没效果
- 格式一:
**
+文本
+*
+斜体文本
+*
+文本
+**
- 示范写法:**君不见*黄河之水*天上来**
- 显示效果:君不见黄河之水天上来
- 格式二:
__
+文本
+*
+斜体文本
+*
+文本
+__
- 格式说明:
__
是由两个下划线_
组成 - 示范写法:__君不见*黄河之水*天上来__
- 显示效果:君不见黄河之水天上来
三、线
3.1 分割线
分割线写法一:***
- 示范写法:***
- 显示效果:
分割线写法二:---
- 示范写法:---
- 显示效果
3.2 删除线
删除线: ~~
+ 文本
+ ~~
- 示范写法:~~这是删除线~~
- 显示效果:
这是删除线
3.3 下划线
下划线:<u>
+ 文本
+ </u>
- 示范写法:<u>这是下划线</u>
- 显示效果:这是下划线
四、列表和引用
4.1 有序列表
有序列表:阿拉伯数字
+ .
+ 空格
+ 文本
- 格式说明:
- 空格不能丢
- 渲染界面会强制顺序显示,它的序号是逐一递进的,编辑界面修改序号将不生效
- 示范写法:
1. 这是第一条数据(注意,点和文字之间有空格)
2. 这是第二条数据
3. 这是第三条数据
4. 这是第四条数据
- 显示效果:
- 这是第一条数据
- 这是第二条数据
- 这是第三条数据
- 这是第四条数据
4.2 无序列表
无序列表:-
+ 空格
+ 文本
- 说明:
+
和*
可以替换-
- 示范写法:
- 这是第一个无序列表
- 这是第二个无序列表
- 这是第三个无序列表
- 这是第四个无序列表
- 显示效果:
- 这是第一个无序列表
- 这是第二个无序列表
- 这是第三个无序列表
- 这是第四个无序列表
4.3 引用
引用:>
+ 文本
- 格式说明:
- 同一个段落内的引用换行时,直接敲一次回车键即可
- 如果需要使用第二个独立段落引用,在换行后,再敲两次回车键,留出空行
- 示范写法: >这里是引用内容
- 显示效果:
这里是引用内容
4.4 缩进&退格
缩进:使用Tab键
退格:使用Shift键 + Tab键
- 说明:引用中使用两个或多个右尖括号
>
来缩进引用,如>>
五、注释&转义字符&空格&换行
5.1 注释
注释:<!--
+ 注释内容
+ -->
- 说明:注释用于对内容和功能进行解释说明,只在编辑界面可见,渲染界面不可见
- 示范写法:<!--这里是注释-->
- 显示效果:无
5.2 转义字符
转义字符: \
+ 特殊字符
- 格式说明:反斜杠
\
的作用是用于转义特殊符号,将特殊符号作为字符本身呈现出来 - 举例说明:星号
*
在markdown
里面可以用作斜体
标识,但是我想显示星号*
本身怎么办?那我们可以使用反斜杠\*
,这样就可以显示星号*
了。其他的特殊符号同理。
5.3 空格
空格:
- 格式说明:使用多少次
,就会产生多少个空格 - 示范写法: 123456
- 显示效果:
-
123456(前面有五个空格)
5.4 换行
换行:<br>
- 格式说明:有些MD编辑器,回车键换行没有效果,可以使用
<br>
换行
六、表格
- 格式说明:
- 【|】是构成表格的主要框架
- 【-】区分表头和表格主体
- 【:】可以设置文本对齐方式
- 【:-】代表左对齐
- 【:-:】代表居中对齐
- 【-:】代表右对齐
- 【<br>】单元格数据较多时,会撑开表格宽度,可以使用<br>换行
- 示范写法:
|表头一|表头二|表头三|
|:-|:-:|-:|
|单元格数据1|单元格数据2|单元格数据3|
|单元格数据4<br>单元格数据4的其余内容|单元格数据5|单元格数据6|
- 显示效果:
表头一 | 表头二 | 表头三 |
---|---|---|
单元格数据1 | 单元格数据2 | 单元格数据3 |
单元格数据4 单元格数据4的其余内容 | 单元格数据5 | 单元格数据6 |
七、代码域
7.1 行内代码
行内代码:两个单反引号
+ 文本
+ 两个单反引号
- 格式说明:
- 只要屏幕够宽,否则行内代码能一直不换行
- 行内代码内不一定只用来写代码,也可以用来强调内容
- 示范写法: ``这里是行内代码``
- 显示效果:
这里是行内代码
7.2 代码块
代码块写法一:在首行和末行各添加三个反引号,内容写在中间行
- 格式说明:
- 首行的符号后面可以添加语言种类
- 语言种类是可选项;
- 语言种类和代码内容之间需要有
空格或换行
- 示范写法:
```java
public calss Test{
public static void main(args:String[]){
println(“Hello World”)
}
}
``` - 显示效果:
public calss Test{
public static void main(args:String[]){
println("Hello World")
}
}
代码块写法二:在首行和末行各添加三个波浪号,内容写在中间行
- 格式说明:
- 首行的符号后面可以添加语言种类
- 语言种类是可选项;
- 语言种类和代码内容之间需要有
空格或换行
- 示范写法:
~~~kotlin
val list = listOf(1,2,3)
list.map{
“i=$it”
}.forEach{
printf(it)
}
~~~ - 显示效果:
val list = listOf(1,2,3)
list.map{
"i=$it"
}.forEach{
printf(it)
}
7.3 代码块的嵌套
代码块的嵌套写法一:使用四个单反引号
嵌套三个单反引号
继续嵌套:使用五个单反引号
嵌套四个单反引号
,以此类推
八、待办任务
任务列表:-
+ 空格
+ [
+ 空格
+ ]
+ 任务内容文本
- 格式说明:在中括号
[ ]
中填入英文字母x,在渲染界面,待办任务前面会显示对勾 - 示范写法:- [ ] 这里是任务内容
- 显示效果:
- 任务内容
九、网页与图像
9.1 网页
网页:[
+ 链接描述
+ ]
+ (
+ 链接地址
+ 空格
+ "
+ 额外信息文本
+ "
+ )
- 格式说明:
- 链接描述:呈现给用户看的文本,用于对链接的说明
- 额外信息文本:额外的提示信息,鼠标悬停时显示的文本,可选项
- 链接地址和额外信息文本之间有空格
- 额外信息文本需要用双引号包裹
- 示范写法:[百度一下,你就知道](http://www.baidu.com “额外的提示信息”)
- 显示效果:百度一下,你就知道
9.2 图像
图像:!
+ 上面的网页格式
- 格式说明:
- 图像链接可以是本地的,也可以是在线的;
- 本地链接可以直接使用复制粘贴
- 示范写法:![文字信息](http://xxx.xxx.xx.png “额外的提示信息”)
- 显示效果:略
十、变量
10.1 网络链接变量
- 示范写法:
- 定义网络内容: [百度一下,你就知道][度娘]
- 定义变量区域:[度娘]:http://www.baidu.com
- 显示效果:百度一下,你就知道
10.2 脚注变量
- 示范写法:
- 定义脚注内容:我的年级是[^1] ,我的班级是[^2]
- 定义变量区域:
[^1]: 三年级
[^2]: 二班
- 显示效果:
十一、扩展文本显示效果
11.1 支持HTML标签
HTML标签:kdb、big、small、font等,可以配合粗体、斜体使用
键盘字体
放大字体
缩小字体
有颜色的字体
11.2 文本高亮
下标:==
+ 文本
+ ==
- 示范写法:==这是一段高亮文本==
- 显示效果:这是一段高亮文本
11.3 上标
上标:文本
+ ^
+ 上标
+ ^
- 说明:也可以使用HTML的
sup
标签 - 示范写法:x^2^
- 显示效果:x2
11.4 下标
下标:文本
+ ~
+ 下标
+ ~
- 说明:也可以使用HTML的
sub
标签 - 示范写法:x~2~
- 显示效果:x2
11.5 表情符号
表情符号:冒号
+ 表情名称
+ 冒号
- 示范写法:
:smile:
:cat:
- 显示效果:😄 🐱
十二、数学公式
12.1 行内公式
行内公式:$
+ 公式
+ $
- 示范写法:$x^2 + 2xy + y^2 = (x+y)^2$
- 显示效果: x 2 + 2 x y + y 2 = ( x + y ) 2 x^2 + 2xy + y^2 = (x+y)^2 x2+2xy+y2=(x+y)2
12.2 公式块
公式块:$$
+ 公式
+ $$
这里不做示范
十三、嵌入
13.1 嵌入音频
嵌入音频:参考HTML、或直接使用编辑器上传
13.2 嵌入视频
嵌入视频:参考HTML、或直接使用编辑器上传
十四、支持各种图
结束语
本文章参考网上文章,并结合了个人实际使用情况。如有任何问题,欢迎反馈和交流