当前位置:   article > 正文

Markdown简明教程_markdown 批注

markdown 批注

Markdown简明教程

前言

在你使用Word或者Pages的时候一定遇到这样的情况:在自己的电脑上排版好的文件,发到别人的电脑上,排版就被打乱了。这时候先别忙着砸电脑,因为学了Markdown之后,或许能解决你的这一烦恼。

什么是Markdown?
Markdown.pngMarkdown 是一种轻量级标记语言那么,什么叫做标记?举个简单的例子:老师拿到期末考试的成绩单后,用绿色记号笔标记出前十名的同学,用红色记号笔表标记出后十名的同学。被绿色记号笔标记的同学没有暑假作业,被红色记号笔标记的同学暑假作业超级加倍,而没有被标记的同学只需要完成普通数量的作业就可以了。在这个例子中我们可以看到,通过不同的标记可以得到不同的结果,而“普通的”则不需要被标记。在Markdown中也是类似的,当你需要给某些文本加上特殊的格式时,你就需要在文本的附近加上标记,而那些普通格式的文本,则不需要添加任何标记。现在,你已经大致明白了什么是标记,那么接下来,我们一起认识各种标记分别代表什么意思吧!

准备工作

老师在开始批注之前,必须有一张成绩表。你得知自己被标记为红色,想要给老师写检讨书,以求高抬贵手时,也需要先在电脑上安装一个Word。

类似的,我们在使用Markdown之前,也需要一个Markdown的编辑器。我比较推荐VScode(免费)当然你也可以使用网页版的编辑器,例如马克飞象等。等你学会之后也可以使用Typora(付费)、MarkText(目前免费)和Obsidian(免费,但是在Markdown的基础上加了一些新的语法),因为这两个编辑器在默认模式下不显示Markdown代码,而是直接显示效果,因此对初学者而言不是十分友好。

值得一提的是,不同编辑器使用的解析引擎可能并不相同,或者使用了同一解析引擎的不同版本,导致在不同编辑器上Markdown的语法可能稍有不同,不过差距不会很大(这一现象被称作“方言”)。因此我比较推荐使用较为大众的编辑器,因为很多小众的编辑器可能对Markdown的支持不是很好。

基础语法

标题语法

在文本前添加井号(#)标记,则这串文本变成了标题,你可以通过控制井号(#)的数量来控制标题字号的大小,一个井号(#)号则是一级标题,两个#号则是二级标题以此类推。一共六级标题。

Markdown代码 效果
# 一级标题 一级标题
## 二级标题 二级标题
### 三级标题 三级标题
#### 四级标题 四级标题
##### 五级标题 五级标题
###### 六级标题 六级标题

考虑到“方言”,可以在井号(#)和文字之间添加一个空格,从而应对编辑器兼容问题。

其实标题还有另外一种语法,但是比较麻烦,这里不做介绍了。学有余力的同学可以去查阅资料,自行学习。

目录语法

在需要插入目录的地方用键盘打上“[TOC]”(引号不用打上,方括号和字母都必须有,其中方括号在英文输入法里才能打出来,在下文中,我也会类似的将需要用英文输入法的符号用红色标出),编辑器就会根据标题语法自动生成目录。

当读者点击目录时,就可以跳转到这篇文章相应的地方。

强调语法

斜体:在需要倾斜的文本两端加上一个星号(*)标记或者一个下划线(_)标记;

粗体:在需要倾斜的文本两端加上两个星号(**)标记或者两个下划线(__)标记;

加粗斜体:在即需要加粗,又需要倾斜的文本两端加上三个星号(***)标记或者三个下滑线(___)标记。

Markdown代码 效果
这是一段倾斜的文字 这是一段倾斜的文字
这是一段倾斜的文字 这是一段倾斜的文字
这是一段加粗的文字 这是一段加粗的文字
这是一段加粗的文字 这是一段加粗的文字
这是一段加粗且倾斜的文字 这是一段加粗且倾斜的文字
这是一段加粗且倾斜的文字 这是一段加粗且倾斜的文字

列表语法

有的教程也叫做“清单”,只是叫法不同,实质上是同一种东西

无序列表:在每一项前面加上星号(*)、加号(+)或者减号(-)紧跟一个空格来创建无序列表.

Markdown代码:

  • 周一
  • 周二
  • 周三

或者

  • 周一
  • 周二
  • 周三

效果:

  • 周一
  • 周二
  • 周三

效果:

  • 周一
  • 周二
  • 周三

使用加号(+)创建无序列表与之类似&

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/从前慢现在也慢/article/detail/207615
推荐阅读
相关标签
  

闽ICP备14008679号