.md即markdown文件的基本经常使用编写语法(图文并茂)

序言:

好久没有写博客了,感受只要是不写博客,人就很变得很懒,学的知识点感受仍是记不住,渐渐地让我明白,看的越多,懂的越少(你这话不是有毛病吗?应该是看的越多,懂的越多才对),此话怎讲,当你在茫茫的前端知识库里面东看看,西看看的时候,很快就被海量的知识给淹没了,根本就不知道哪些是对的,哪些是错的,感受好像这个也懂了,那个也懂了,可是真正写起来,脑子又一片空白,又好像什么都不懂,这种状态时有发生,这就叫不懂装懂,最根本的缘由就是看的太多,写的太少,因此为了改掉这样毛病,把被动学习变成主动学习,接下来的日子,多写写,即便是写一些学习工做中遇到的坑也是好的,没事翻出来看看,还能够加深印象,好了,废话处处!html

原由:前端

由于如今的前端基本上都用上了前端构建工具,那就不免要写一些readme等等的说明性文件,可是这样的文件通常都是.md的文件,编写的语法天然跟其余格式的文件有所区别,置于为何要用这种格式的文件,不要问我,我也不知道,你们都这么用,跟着用就对了,若是有大神知道的,不妨告知小弟,本文也是我学习写markdown文件的一个笔记吧,仅供参考!markdown

正文:app

一、标题的几种写法:前端构建

第一种:编辑器

   

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

第二种:学习

    

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

第三种:.net

   

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

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

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

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

二、列表

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

   

能够看到,无序列表能够用* , + , — 来建立,用在线编辑器看,其实是转换成了ul>li ,因此使用哪一个均可以,推荐使用*吧

    

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

      

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

 

三、区块引用

好比说,你想对某个部分作的内容作一些说明或者引用某某的话等,能够用这个语句

  

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

引用由于是一个区块,理论上是应该什么内容均可以放,好比说:标题,列表,引用等等,看看下图:

   

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

    

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

 

四、华丽的分割线

分割线能够由* - _(星号,减号,底线)这3个符号的至少3个符号表示,注意至少要3个,且不须要连续,有空格也能够

   

应该看得懂吧,可是为了代码的排版好看,大家本身定规则吧,前面有用到星号,建议用减号

 

五、连接

支持2种连接方式:行内式和参数式,无论是哪种,连接文字都是用 [方括号] 来标记。

    

上图可知,行内式的连接格式是:连接的文字放在[]中,连接地址放在随后的()中,触类旁通,常常出现的列表连接就应该这样写:

  

连接还能够带title属性,好像也只能带title,带不了其余属性,注意,是连接地址后面空一格,而后用引号引发来

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

    

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

[foo]: http://example.com/ "Optional Title Here"

[foo]: http://example.com/ 'Optional Title Here'

[foo]: http://example.com/ (Optional Title Here)

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

[foo]: <http://example.com/> "Optional Title Here"

其实还有一种隐式连接的写法,可是我以为那种写法不直观,因此就不写了,常常用的通常就上面2种,若是你想了解隐式连接,能够看我文章最后放出的参考地址

 

六、图片

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

   

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

 

七、代码框

这个就比较重要了,不少时候都须要展现出一些代码

若是代码量比较少,只有单行的话,能够用单反引号包起来,以下:

   

要是多行这个就不行了,多行能够用这个:

    

多行用三个反引号,若是要写注释,能够在反引号后面写

八、表格

这个写的有点麻烦,注意看

    

从这3种不一样写法看,表格的格式不必定要对的很是起,可是为了好看,对齐确定是最好的,第一种的分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中,仍是有点意思的,不过现实出来的结果是,表格外面并无线框包起来,不知作别人的怎么弄的

 

九、强调

     

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

十、转义

     

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

十一、删除线

   

 

经常使用的基本上就这些了,若是还有一些经常使用的,能够跟我留言,我补充上去,我以为图文并茂才是高效学习的正确姿式,希望为你的学习带来帮助!

 

参考文献:

http://www.appinn.com/markdown/

http://sspai.com/25137

 

原创不易,如需转载,请标明出处!