Markdown语法整理

Markdown语法整理

• 目录

  • 6.1.竖杠|下划线-写法

  • 6.2.htmltable写法

  • 5.1.无需列表

  • 5.2.有序列表

  • 5.3.定义型列表

  • 5.4.列表缩进

  • 5.5.包含段落的列表

  • 4.1.页内超链接

  • 4.2.文章内部标题链接

  • 3.1.行内式:

  • 3.2.参考式

  • 3.3.自动连接

  • 一.分级目录

  • 二.斜体与粗体

  • 三.超链接

  • 四.锚点

  • 五.列表

  • 六.表格

说明：本文中中语法里面的代码就是需要写的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/>
   <admin@baidu.com>

说明：Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用<>包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

展示效果：

http://www.baidu.com/

admin@baidu.com

四.锚点

网页中，锚点其实就是页内超链接，也就是链接本文档内部的某些元素，实现当前页面中的跳转。比如我这里写下一个锚点，点击回到目录，就能跳转到目录。 在目录中点击这一节，就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。

注意：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)

<h4 id='21'>标题1</h4>
    轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。
<h4 id='22'>标题2</h4>
    正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。
<h4 id='23'>标题3</h4>
    我轻轻的招手， 作别西天的云彩。
<h4 id='24'>标题4</h4>
    作别西天的云彩。

展示效果：

• 目录

  • 标题1

  • 标题2

  • 标题3

  • 标题4

标题1

轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。

标题2

正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。

标题3

我轻轻的招手， 作别西天的云彩。

标题4

作别西天的云彩。

五.列表

5.1.无需列表:

使用 *，+，- 表示无序列表

语法：

    - 无序列表一
    + 无序列表二
    * 无序列表三

展现效果：

• 无序列表一

• 无序列表二

• 无序列表三

5.2.有序列表：

有序列表则使用数字接着一个英文句点

语法：

    1.有序列表一
    2.有序列表二
    3.有序列表三

展现效果：

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|美国|

展现效果：

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>

展现效果：

说明：这里有点奇怪，为什么那么大空格，目前没有找到原因，跳转至首页

因为Markdown语法简洁明了，在日常整理文档时很不错，就网上搜索，经过自己整理验证，贡献出来，以便需要的网友们参考，如果文档中有错误的，或者看着不明了的，希望留言，以便纠正