Markdown 简明教程

基本介绍

• Markdown是一种用来写作的轻量级标记语言。
• 用标记语法，来代替常见的排版格式。
• 兼容 HTML代码。
• 特殊字符自动转换，例如<和&。

字体效果

• 使用星号*和底号_表示em标签。

      例如：
  
      *斜体*
      _斜体_
      效果：
  
      斜体
  

• 使用双星号**和双底号__表示strong标签。

      例如：
  
      **强调**
      __强调__
      效果：
  
      强调
  

标题

• 生成h1,h6标签，是通过在文字前面加上同等个数#符号来实现。

• 出于美观，也可以使用对称的闭合式标题符号。

      例如：
  
      ## 这是标题
      ## 这是标题 ##
      效果：
  

这是标题

列表标示

• *，-，+这三个符号效果都一样，这3个符号被称为Markdown列表符号。而有序列表则使用数字接着一个英文句点（数字大小并不会影响输出序列）。
  例如：

• 第一行

• 第二行
• 第三行
  
  1. 第四行
  2. 第五行
  3. 第六行
     效果：

第一行
第二行
第三行
第一行
第二行
第三行

引用说明

• >符号表示引用，可简写于第一行，也可以每一行都添加。
• 区块的引用可以嵌套，只需要在层次数上加上同等数量的>符号。
• 引用内可以使用其他Markdown语法，包括标题、列表、代码区块等。

例如：

        > 引用
        > > 引用中的引用
        效果（本例本身处于引用效果中）：

        引用

        引用中的引用

引用

引用中的引用
效果（本例本身处于引用效果中）：

引用

引用中的引用

代码段

• `是表示inline代码，4个 （空格）来表示缩进式代码段，分别对应HTML的code，pre标签。也可以使用“`来表达围栏式代码块（GFM语法），并指定他的语言类型，实现语法高亮。围栏式代码块可以大量减少缩进的使用，大规模的代码块使用非常方便。

例如：

        `sort()` 函数按升序对给定数组的值排序。

            <?php
                $my_array = array("a" => "Dog", "b" => "Cat");
                sort($my_array);
                print_r($my_array);
            ?>

        ```php
        <?php
            $my_array = array("a" => "Dog", "b" => "Cat");
            sort($my_array);
            print_r($my_array);
        ?>
        ```

效果：

普通的缩进式代码块。

sort() 函数按升序对给定数组的值排序。

<?php
    $my_array = array("a" => "Dog", "b" => "Cat");
    sort($my_array);
    print_r($my_array);
?>

带语法高亮的围栏式代码块（GFM语法）。

<?php
    $my_array = array("a" => "Dog", "b" => "Cat");
    sort($my_array);
    print_r($my_array);
?>

链接

• Markdown支持两种形式的链接语法：行内式和参考式两种形式。
  行内式链接，是在方括号后面接圆括号即可。 例如：

  [jeanphorn](http://blog.csdn.net/jeanphorn "jeanphorn的博客")
  

效果：

jeanphorn

参考式链接，是在链接文字的括号后面加上另一个方括号，在第二个方括号里面要填入用以辨识链接的标记。 例如：

        [jeanphorn][blog]
        [blog]: http://blog.csdn.net/jeanphorn "jeanphorn的博客"

效果：

jeanphorn

插入图片

• Markdown使用一种和链接很相似的语法来标记图片，只是多了一个!在最前面，同样也允许两种样式：行内式和参考式。
  行内式链接，是在方括号后面接圆括号即可。 例如：

      ![csdn](http://img.blog.csdn.net/20141210161321639?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvSmVhbnBob3Ju/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center "csdn")
  

效果如下：

分割线

• 使用三个以上的*、-来建立一个分隔线，行内不能有其他字符。
  例如：

      * * *
  
      ***
      上文
      - - -
      下文
      ---
      效果：
  

效果如下：

上文

下文