Markdown语法整理
说明:本文中中语法里面的代码就是需要写的Markdown语法,展示效果就是最后生成的页面
此语法编写和测试环境:windows上使用MarkdownPad2的GitHub风格的Markdown语法
一.分级目录
语法:
* 总目录 * 一级目录 * 二级目录 * 三级目录
说明:层级列表一般只支持三级列表,第一级实心圆点,第二级空心圆点,第三级以后都是实心方点。要实现层级列表,每下一级都要比上一级多输入2个空格或者一个Tab,而且第一级前面不要超过3个空格.
展示效果:
- 总目录
- 二级目录
- 三级目录
- 一级目录
二.斜体与粗体
语法:
*斜体* **粗体**
展示效果:
斜体
粗体
三.超链接
Markdown支持两种形式的链接语法:行内式和参考式,行内式一般用的比较多。
3.1.行内式:
语法:
[打开百度](http://www.baidu.com) [打开百度](http://www.baidu.com "打开百度")
说明:[]里写链接文字,()里写链接地址, ()中的”“中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。[链接文字](链接地址 “链接标题”)这样的形式。链接地址与链接标题前有一个空格。
展示效果:
3.2.参考式:
参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。
语法:
我经常浏览的几个网站[Google][1]、[Baidu][2]、[51CTO][3]和看视频的网站[爱奇艺][4]感觉都是很不错的[网站][]. [1]:http://www.google.com "google" [2]:http://www.baidu.com "Baidu" [3]:http://www.51cto.com "51cto" [4]:http://www.aiqiyi.com "aiqiyi" [网站]:http://www.qq.com
展示效果:
我经常浏览的几个网站Google、Baidu、51CTO和看视频的网站爱奇艺感觉都是很不错的网站.
3.3.自动连接:
语法:
<http://www.baidu.com/> <[email protected]>
说明:Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。
展示效果:
[email protected]
四.锚点
网页中,锚点其实就是页内超链接,也就是链接本文档内部的某些元素,实现当前页面中的跳转。比如我这里写下一个锚点,点击回到目录,就能跳转到目录。 在目录中点击这一节,就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。
注意:Markdown Extra 只支持在标题后插入锚点,其它地方无效
4.1.页内超链接:
语法:
# 1.分级目录{#index} 跳转到[标题]{#index}
说明:在你准备跳转到的指定标题后插入锚点{#标记},然后在文档的其它地方写上连接到锚点的链接。此处使用的是GitHub风格的Markdown语法所以无法正常显示效果,推荐使用以下4.2.文章内部标题链接。
展示效果:
1.分级目录{#index}
跳转到1.分级目录
说明:这里是在本文的分级目录设置的,不然效果不明显
4.2.文章内部标题链接:
语法:
* [目录1](#20) * [标题1](#21) * [标题2](#22) * [标题3](#23) * [标题4](#24) <h3 id=‘21‘>标题1</h3> 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。 <h3 id=‘22‘>标题2</h3> 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。 <h3 id=‘23‘>标题3</h3> 我轻轻的招手, 作别西天的云彩。 <h3 id=‘24‘>标题4</h3> 作别西天的云彩。
展示效果:
标题1
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
标题2
正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
标题3
我轻轻的招手, 作别西天的云彩。
标题4
作别西天的云彩。
五.列表
5.1.无需列表:
使用 *,+,- 表示无序列表
语法:
- 无序列表一 + 无序列表二 * 无序列表三
展现效果:
- 无序列表一
- 无序列表二
- 无序列表三
5.2.有序列表:
有序列表则使用数字接着一个英文句点
语法:
1.有序列表一 2.有序列表二 3.有序列表三
展现效果:
- 有序列表一
- 有序列表二
- 有序列表三
5.3.定义型列表:
语法:
Markdown : 轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格) 代码块 2 : 这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格) 代码块(左侧有八个不可见的空格)
说明:
定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)
展现效果:
Markdown
: 轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格)
代码块 2
: 这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)
代码块(左侧有八个不可见的空格)
5.4.列表缩进:
语法:
* 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。 那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草! * 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
说明:列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
效果:
- 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草! - 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
5.5.包含段落的列表:
语法:
* 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。 那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草! 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。 寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! * 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
说明:
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致):如果你每行都有缩进,看起来会看好很多,当然,再次地,如果你很懒惰,Markdown 也允许
效果:
- 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! - 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
六.表格
6.1.竖杠|
下划线-
写法:
语法:
|名字|性别|年龄|国籍| |-----------------| |张三|男|23|中国| |小红|女|18|中国| |Tom|男|46|美国|
展现效果:
名字 | 性别 | 年龄 | 国籍 |
---|---|---|---|
张三 | 男 | 23 | 中国 |
小红 | 女 | 18 | 中国 |
Tom | 男 | 46 | 美国 |
6.2.htmltable
写法:
语法:
<table> <tr> <td>车次</td> <td>开车时间</td> <td>到达时间</td> </tr> <tr> <td>D110</td> <td>10:22</td> <td>11:00</td> </tr> </table>
展现效果:
车次 | 开车时间 | 到达时间 |
D110 | 10:22 | 11:00 |
说明:这里有点奇怪,为什么那么大空格,目前没有找到原因,跳转至首页
因为Markdown语法简洁明了,在日常整理文档时很不错,就网上搜索,经过自己整理验证,贡献出来,以便需要的网友们参考,如果文档中有错误的,或者看着不明了的,希望留言,以便纠正