一.分级目录

语法:

* 总目录
  * 一级目录
    * 二级目录
      * 三级目录

说明:层级列表一般只支持三级列表,第一级实心圆点,第二级空心圆点,第三级以后都是实心方点。要实现层级列表,每下一级都要比上一级多输入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"

展示效果:

我经常浏览的几个网站GoogleBaidu51CTO和看视频的网站爱奇艺感觉都是很不错的网站.

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.文章内部标题链接。

展示效果:

跳转到[一.分级目录]{#一.分级目录}

说明:这里是在本文的分级目录设置的,不然效果不明显

4.2.文章内部标题链接:

语法:

* [目录1](#40)
   * [标题1](#41)
   * [标题2](#42)
   * [标题3](#43)
   * [标题4](#44)

<h3 id="41">标题1</h3>
   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="42">标题2</h3>
   正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="43">标题3</h3>
   我轻轻的招手, 作别西天的云彩。
<h3 id="44">标题4</h3>
   作别西天的云彩。

展示效果:

<h3 id="41">标题1</h3>
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="42">标题2</h3>
正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="43">标题3</h3>
我轻轻的招手, 作别西天的云彩。
<h3 id="44">标题4</h3>
作别西天的云彩。

五.列表

5.1.无序列表:

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

语法:

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

展现效果:

  • 无序列表一
  • 无序列表二
  • 无序列表三

5.2.有序列表:

有序列表则使用数字接着一个英文句点接一个空格再接内容

语法:

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

展现效果:

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

5.3.定义型列表:

语法:

名词1
:    定义 1(左侧有一个可见的冒号和四个不可见的空格)

代码块 2
:    这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)

代码块(左侧有八个不可见的空格)

说明:定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)

展现效果:

名词1
: 定义 1(左侧有一个可见的冒号和四个不可见的空格)

代码块 2
: 这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)

代码块(左侧有八个不可见的空格)

5.4.列表缩进:

语法:

*   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
*   那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

说明:列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。

展现效果:

  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
    那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。

软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!

  • 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
    但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!

悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

5.5.包含段落的列表:

语法:

*   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!

    那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
*    悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

说明:

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致):如果你每行都有缩进,看起来会看好很多,当然,再次地,如果你很懒惰,Markdown 也允许

展现效果:

  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
    那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。

软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!

那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!

  • 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

5.6.任务列表:

要创建任务列表,前缀列表项[ ]。要将任务标记为完整,请使用[x]

语法:

   - [ ] 跑步
   - [ ] 骑车
   - [x] 吃饭
   - [ ] 睡觉

展现效果:

  • [ ] 跑步
  • [ ] 骑车
  • [x] 吃饭
  • [ ] 睡觉

六.表格

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

使用竖杠|下划线-写法

语法:

|名字|性别|年龄|国籍|
|---|----|----|---|
|张三|男|23|中国|
|小红|女|18|中国|
|Tom|男|46|美国|

展现效果:

名字性别年龄国籍
张三23中国
小红18中国
Tom46美国

6.2.html写法:

语法

 <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

七.创建和突出显示代码块

7.1.栅栏代码块:

语法:

function test() {
    console.log(“在此函数之前注意空白行?");
    }

展现效果:

  function test() {
    console.log(“在此函数之前注意空白行?");
  }

7.2.语法高亮显示:

高亮需要解析支持才有效果

语法:

    require 'redcarpet'
    markdown = Redcarpet.new("Hello World!")
    puts markdown.to_html

展现效果:

ruby语法:

    require 'redcarpet'
    markdown = Redcarpet.new("Hello World!")
    puts markdown.to_html

python语法:

       def foo():
       if not bar:
           return True

7.3.引用代码:

您可以使用单个反引号来调用句子中的代码或命令。反引号内的文本将不被格式化。

语法:

Use `git status` to list all new or modified files that haven't yet been committed.

展现效果:

Use git status to list all new or modified files that haven't yet been committed.

7.4.引用文字:

你可以用引用文本>

语法:

In the words of Abraham Lincoln:

> Pardon my French

展现效果:

In the words of Abraham Lincoln:

Pardon my French

7.5.删除线:

语法:

~~This was mistaken text~~

展现效果:

This was mistaken text