工具集核心教程 | 第一篇： .md即markdown文件的基本经常使用编写语法（图文并茂）

序言:

---

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

原由：

由于如今先后端、测试交互很频繁，一个完整的项目或者教程，说明性文件必不可少！那就不免要写一些readme等等的说明性文件，可是这样的文件通常都是.md的文件，编写的语法天然跟其余格式的文件有所区别，置于为何要用这种格式的文件，不要问我，我也不知道，你们都这么用，跟着用就对了，若是有大神知道的，不妨告知小弟，本文也是我学习写markdown文件的一个笔记吧，仅供参考！

正文：

1.标题的几种写法：

第一种：

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

第二种：

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

第三种：

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

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

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

在线地址请看这里： markdown在线编辑 （只是想看看背后的转换原理，没有广告之嫌）

2.列表

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

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

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

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

3.区块引用

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

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

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

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

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

4.华丽的分割线

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

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

5.连接

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

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

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

这是行内式的写法，参数式的怎么写：

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

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

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

6.图片

图片也有2种方式：行内式和参数式，

用法跟连接的基本同样，惟一的不一样就是，图片前面要写一个！（这是必须的），没什么好说的

7.代码框

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

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

要是多行这个就不行了，多行能够用这个，也就是一对`：

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

8.表格

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

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

9.强调

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

10.转义

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

11.删除线

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

最后推荐一款Window下markdown编辑器

typora很是好用的一款本地MD文件编辑器 ,中文版下载地址：typora下载
界面以下：

参考文献：

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

http://sspai.com/25137

写在最后

欢迎关注、喜欢、和点赞后续将推出更多的工具集教程，敬请期待。
欢迎关注个人微信公众号获取更多更全的学习资源，视频资料，技术干货！

公众号回复“学习”，拉你进程序员技术讨论群，干货资源第一时间分享。

公众号回复“视频”，领取800GJava视频学习资源。

公众号回复“全栈”，领取1T前端，Java，产品经理，微信小程序，Python等资源合集大放送。

公众号回复“慕课”，领取1T慕课实战学习资源。

公众号回复“实战”，领取750G项目实战学习资源。

公众号回复“面试”，领取8G面试实战学习资源。