码迷,mamicode.com
首页 > 其他好文 > 详细

Markdown 简明教程

时间:2015-04-04 09:23:23      阅读:139      评论:0      收藏:0      [点我收藏+]

标签: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")
    

效果如下:

技术分享

分割线

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

        * * *
    
        ***
        上文
        - - -
        下文
        ---
        效果:
    

效果如下:


上文


下文


Markdown 简明教程

标签:markdown   教程   

原文地址:http://blog.csdn.net/jeanphorn/article/details/44857973

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!