之前项目文档师兄都是用Markdown语法来写的,一直想系统地看看其语法,结果一直没行动起来,正好今晚整理博客,就想着看看,整理一下。(发现自己的拖延症真的要严重)
标题设置
在Markdown当中设置标题,有两种方式:
第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。如:
(Markdown会自动把每行前面空四格的文本转换为代码块)
=和-的个数无要求
第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)
斜体和粗体
斜体:两端使用1个”*
“或者”_
“夹起来
粗体:两端使用2个”*
“或者”_
“夹起来
效果如下:
斜体或者斜体
粗体
加粗斜体删除线
超链接
Markdown支持两种方式的超链接,行内式和参考式,其中行内式用的比较多
行内式
|
|
链接标题可加可不加,只是鼠标悬停在地址上,会显示的文字
参考式
参考式链接主要用于以下场景,比如学术论文里或者是多次引用该地址
我经常去的几个网站[Google][1]、[Leanote][2],[Leanote 笔记][2]是一个不错的[网站][]。 [1]:http://www.google.com "Google" [2]:http://www.leanote.com "Leanote" [网站]:http://http://blog.leanote.com/freewalk
自动链接
有时候我们会想直接把链接地址显示出来,比如想直接把我的博客地址展示,可以通过<https://ily11.github.io/>
直接用<>包起来的方式展示。
列表
无序列表
使用 *
,+,- 表示无序列表。
有序列表
有序列表则使用数字接着一个英文句点。
解释型列表
第一行写定义,然后下一行有一个冒号和四个空格,如果要引入代码块,就是八个空格
Markdown : 轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格) 代码块 2 : 这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格) 代码块(左侧有八个不可见的空格)
引用
一般引用就是用“>”加一个空格即可,当然也可以嵌套引用,即用多个“>”实现嵌套引用。
引用代码的话,只要在“>”+空格后再加4个空格即可
插入图像
插入图像跟超链接一样都是有两种方式,而且类似,其一般格式是:
语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。
代码
行内插入短代码,可以直接用Tab键下的符号来包裹代码,如果是多行代码,可以用4个空格,Markdown会自动识别前面有4个空格的为代码块,直到没有4个空格为止,还可以用6个Tab键下的符号,前面三个,后面三个包裹起来。
表格
|
|
效果如下:
Title | Data | tags |
---|---|---|
aaaa | 2017-1-20 | css |
bbbb | 2016-12-20 | js |
cccc | 2016-10-11 | html |
表格写法要在前面空一行