谁能通俗的说明白Markdown具体怎么用?

2022-05-07时事191

起因:因为现在的前端基本上都用上了前端构建工具,那就难免要写一些readme等等的说明性文件,但是这样的文件一般都是.md的文件,编写的语法自然跟其他格式的文件有所区别,置于为什么要用这种格式的文件,不要问我,我也不知道,大家都这么用,跟着用就对了,如果有大神知道的,不妨告知小弟,本文也是我学习写markdown文件的一个笔记吧,仅供参考!

正文:1、标题的几种写法:第一种:

前面带#号,后面带文字,分别表示h1-h6,上图可以看出,只到h6,而且h1下面会有一条横线,注意,#号后面有空格

第二种:

这种方式好像只能表示一级和二级标题,而且=和-的数量没有限制,只要大于一个就行

第三种:

这里的标题支持h1-h6,为了减少篇幅,我就偷个懒,只写前面二个,这个比较好理解,相当于标签闭合,注意,标题与#号要有空格

那既然3种都可以使用,可不可以混合使用呢?我试了一下,是可以的,但是为了让页面标签的统一性,不建议混合使用,推荐使用第一种,比较简洁,全面

为了搞清楚原理,我特意在网上搜一下在线编写markdown的工具,发现实际上是把这些标签最后转化为html标签,如图:

在线地址请看这里: markdown在线编辑 (只是想看看背后的转换原理,没有广告之嫌)

2、列表我们都知道,列表分为有序列表和无序列表,下面直接展示2种列表的写法:

可以看到,无序列表可以用* , + , — 来创建,用在线编辑器看,实际上是转换成了ulli ,所以使用哪个都可以,推荐使用*吧

有序列表就相对简单一点,只有这一种方式,注意,数字后面的点只能是英文的点,特别注意,有序列表的序号是根据第一行列表的数字顺序来的,比如说:

第一组本来是3 2 1 倒序,但是现实3 4 5 ,后面一组 序号是乱的, 但是还是显示 3 4 5 ,这点必须注意了

3、区块引用比如说,你想对某个部分做的内容做一些说明或者引用某某的话等,可以用这个语句

无序列表下方的便是引用,可以有多种用途,看你的需求了,用法就是在语句前面加一个 ,注意是英文的那个右尖括号,注意空格

引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等,看看下图:

将上面的代码稍微改一下,全部加上引用标签,就变成了一个大的引用,还有引用里面还有引用,那引用嵌套引用还没有别的写法呢?

上图可以看出,想要在上一次引用中嵌套一层引用,只需多加一个,理论上可以无限嵌套,我就不整那么多了,注意:多层嵌套的是不需要连续在一起的,只要在一行就可以了,中间允许有空格,但是为了好看,还是把排版搞好吧

4、华丽的分割线分割线可以由* - _(星号,减号,底线)这3个符号的至少3个符号表示,注意至少要3个,且不需要连续,有空格也可以

应该看得懂吧,但是为了代码的排版好看,你们自己定规则吧,前面有用到星号,建议用减号

5、链接支持2种链接方式:行内式和参数式,不管是哪一种,链接文字都是用 [方括号] 来标记。

上图可知,行内式的链接格式是:链接的文字放在[]中,链接地址放在随后的中,举一反三,经常出现的列表链接就应该这样写:

链接还可以带title属性,好像也只能带title,带不了其他属性,注意,是链接地址后面空一格,然后用引号引起来

这是行内式的写法,参数式的怎么写:

这就好理解了,就是把链接当成参数,适合多出使用相同链接的场景,注意参数的对应关系,参数定义时,这3种写法都可以:

[foo]:

[foo]: '

[foo]: )

还支持这种写法,如果你不想混淆的话:

[foo]:

其实还有一种隐式链接的写法,但是我觉得那种写法不直观,所以就不写了,经常用的一般就上面2种,如果你想了解隐式链接,可以看我文章最后放出的参考地址

6、图片图片也有2种方式:行内式和参数式,

用法跟链接的基本一样,唯一的不同就是,图片前面要写一个!(这是必须的),没什么好说的

7、代码框这个就比较重要了,很多时候都需要展示出一些代码

如果代码量比较少,只有单行的话,可以用单反引号包起来,如下:

要是多行这个就不行了,多行可以用这个:

多行用三个反引号,如果要写注释,可以在反引号后面写

8、表格这个写的有点麻烦,注意看

从这3种不同写法看,表格的格式不一定要对的非常起,但是为了好看,对齐肯定是最好的,第一种的分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中,还是有点意思的,不过现实出来的结果是,表格外面并没有线框包起来,不知道别人的怎么弄的

9、强调

一个星号或者是一个下划线包起来,会转换为em倾斜,如果是2个,会转换为strong加粗

10、转义

就不一一列举了,基本上跟js转义是一样的

11、删除线

常用的基本上就这些了,如果还有一些常用的,可以跟我留言,我补充上去,我觉得图文并茂才是高效学习的正确姿势,但愿为你的学习带来帮助!

相关文章

神之刃圣痕升级攻略,圣痕怎么升级?

圣痕怎么升级?    点击圣痕具体信息中的“升级”按钮进入升级界面    点击圣痕列表后面的小方框可以选择/取消吞噬圣痕    已经装备的圣痕是不会出现再该列表中的    1. 要升级圣痕信息    2. 圣痕已拥有经验    3. 圣痕吞噬后拥有经验    4. 圣痕吞噬后经验/圣痕升级所...

有什么网站或者app可以看外国的新闻呢?

给你说说看国外新闻的三种方案: 1.通过邮件订阅的方式纯正的国外新闻呢,还是可以通过邮件订阅的形式进行收集查看的。国外还是比较流行这种方式,就是把自己邮箱填写进去,就订阅好了。 但是问题是你没办法去到国外网站,如何填写邮件地址呢? 别喷我,国内有好多的订阅助手。 自己找,或者私聊,我帮你找。 2.中...

Java学习视频选毕向东还是马士兵还是腾讯课堂之类的?

我的建议是先从毕向东的视频课程开始学习,整体看完之后,觉得这种视频哪部分知识点讲的不是对自己有太大帮助,可以根据知识关键字从剩下的两种视频课程中选择观看,吸取其中的部分精华。 我来解释下,为什么要按照上面的方式去学习呢?主要是因为我们的学习精力有限,市面上有太多的学习资料,这会让我们目不暇接,而且过...

淘宝上面的秒杀是什么意思有什么作用?

淘宝秒杀是网络卖家发布一些超低价格的商品,所有买家在同一时间网上抢购的一种销售方式。抢拍与竞拍是完全两个概念,竞拍是看谁出价最高,而抢拍是价格固定,看谁先拍到。 秒杀就是从抢拍过度而来的词汇。从卖家角度来讲,利用抢拍这种销售方式可以让买家更有购买欲望。 只是知道很多人都想要,那么就凭这个人气,你就想...

性欲是怎样产生的?

性的要求就是性欲,是机体的本能反应。性不仅仅是肉体上的结合,而且还有更广泛的社会内容——共同的信仰、志向、兴趣、诚挚亲密的情感与和谐的生活方式是性爱的基础。性爱强调一种温柔挚爱的情感和肉体上的欲望的有机结合。性欲的强大力量使性爱成为一种炽热、永恒的情感源泉,而感情的融合又使性欲能够得到极大的激发和满...

如何开具计划生育证明?

开计划生育证明:   1、未婚未育的。标题写“计划生育证明”;内容写清住址(X街道X村居或小区)、姓名、出生年月,然后写未婚未育、无收养抱养小孩,没有违反计划生育政策;内容写完后写上“特此证明”,由经办部门签字、盖章,如果需要可以写上意见。   2、未婚有生育的。格式同上,在内容上要修改为未婚、X年...

中国版《七天》整部电影结局怎么样?

电影《七天》的最终凶手是郑铁镇,被送上法庭又被放了。被杀女孩的母亲知道凶手是郑铁镇,从她打碎石膏雕塑发现那把刀时。她为了要用最痛苦的方式杀死这个杀人犯。要用自己办法报复他。 而不是很便宜地绞死他,从而绑架了女主律师的女儿,逼她想办法证明凶手无罪,郑铁镇被无罪释放,后来被母亲用火烧死了。 给这部电影做...

网警辟谣|腾讯新闻发布:qq群内提供的网络彩票投注方案,准确率竟达85%?假假假!

看到这些抄袭新闻格式的文章是否有是曾相识的感觉呢??? 这些都是网络赌博不法分子的计谋,还套上了腾讯新闻的图片 腾讯新闻客户端 : 新闻格式上看起来真假难辨,但是相信机智的网民一定能识别出这个套路!谢谢细心的微博网友@黑椒猪扒咕噜肉 给我们的举报。 深圳网警呼吁: 广大网民朋友看到网上的违法行为,动...

双绞线的连接方式?

双绞线的连接方式:双绞线常用的连接方式是直接连接和交叉连接。 1.直接连接方式就是使两端RJ-45水晶头中的线序排列完全相同,称为直通线(Straight Cable)方式,也称为正常双绞线连接方式。该连接方式只适用于网卡到集线器(交换机)。 2.交叉连接方式水晶头一端遵循568A,而另一端遵循56...

自媒体怎么发视频跟写简介?

视频简介往往要带上关键词,交代视频的一些剧情,但是简介不是最核心的,标题,标签,封面,选题才是影响播放量的因素,所以可以简单写简介即可! 至于怎么发视频,这个就要涉及自媒体的更新频率、更新的时间点以及更新的数量等等,还要关注粉丝的活动时间,在自己粉丝最活跃的时间发布视频,就能获得更多的关注和推荐量。...

日本黑帮合法吗?为什么?

合法,也是唯一合法。 日本的黑社会其实并没有那么黑,黑社会成员们也没有那么凶神恶煞。 说起日本黑帮,他们是全世界唯一合法的黑社会,并且与当地的警察维持着微妙的关系,一个管理白天,一个操控黑夜。 在日本,加入黑帮被视为是一种正当的生活方式,这对许多怀揣着个人主义英雄梦和身无一技之长的人来说,是日本的社...

excel表格透视表怎么做?

大家好,我是Excel大全,头条原创作者,每日分享实用Excel小技巧。 刚好看见这个问题,我就来分享下我的经验,希望能帮到你! 我将从以下方面回答这个问题:数据透视表怎么做? 一个简单例子,使用透视表,无需任何公式,3步搞定分组统计; 插入透视表的方式; 透视表布局; 分组统计; 计算字段; 切片...