Markdown语法整理
Posted
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Markdown语法整理相关的知识，希望对你有一定的参考价值。
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 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。
展示效果：
http://www.baidu.com/
[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语法简洁明了，在日常整理文档时很不错，就网上搜索，经过自己整理验证，贡献出来，以便需要的网友们参考，如果文档中有错误的，或者看着不明了的，希望留言，以便纠正
本文出自 “淡淡人生” 博客，请务必保留此出处http://guojianwei2008.blog.51cto.com/4272617/1947814
以上是关于Markdown语法整理的主要内容，如果未能解决你的问题，请参考以下文章