Markdown基础语法总结

目录

  • 区块元素
    • 标题

    • 列表

    • 区块引用

    • 代码区块

    • 分隔线

    • 段落和换行

  • 区段元素
    • 链接

    • 强调

    • 代码

    • 图片

    • 转义


  1. 标题 <a name="title"></a>

    • 类Setext

      This is an H1

      This is an H2

        Code:
      
        This is an H1   
        ====
        This is an H2
        ----
      

      备注:任何数量的=和-都可以有效果

      =表示最高阶标题,-表示第二阶标题

    • atx形式

      This is an H1

      This is an H2

      This is an H3

      This is an H4

      This is an H5
      This is an H6
        Code:
      
        # This is an H1
      
        ## This is an H2
      
        ### This is an H3
      
        #### This is an H4
      
        ##### This is an H5
      
        ###### This is an H6 
      

      也可以表示成这样 # This is an H1 #
      备注: 行首n个#表示n阶标题,n最大为6

  2. 列表

    • 有序列表

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

      1. Bird
      2. McHale
          Code:
          1. Bird
          2. McHale
      
    • 无序列表

      无序列表是使用,+,-中任意一种来表示

      • Red
      • Green
      • Blue
          Code:
          - Red
          + Green
          * Blue
      
  3. 引用

    区块引用是使用类似email中用>来表示

    示例

     > 简单引用1
     > 简单引用2
     > 
     > 多行引用
     >> 嵌套引用
    
     > ## 引用中使用Markdown语法。
     > 
     > 1.   这是第一行列表项。
     > 2.   这是第二行列表项。
     > 
     > 给出一些例子代码:
     > 
     >     return shell_exec("echo $input | $markdown_script");
    

    效果

    简单引用1
    简单引用2

    多行引用

    嵌套引用

    引用中使用Markdown语法。

    1. 这是第一行列表项。
    2. 这是第二行列表项。

    给出一些例子代码:

      return shell_exec("echo $input | $markdown_script");
    
  4. 代码区块

    建立代码区块,只需要简单地缩进4个空格或是1个制表符就可以
    代码块一直持续到没有缩进的那一行(或是文件的结尾)

    也可以使用` 来表示

     代码块
    
     使用缩进表示代码块
    
  5. 分隔线

    一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西,
    也可以在星号或是减号中间插入空格


     ---
    

     - - -
    

     ***
    

     * * *
    

     ——————————————
    
  6. 段落和换行

    • 段落

      段落是由一个或多个连续的文本行组成,
      它的前后要一个以上的空行(显示上看起来像是空的)

    • 换行

      Mardown允许段落内的强迫换行(插入换行符)
      要依赖Markdown来插入<br/>标签的话,在<br/>插入处要先按入两个以上的空格然后回车

  7. 链接

    支持两种形式的连接语法: 行内式参考式
    链接字符不区分大小写

    • 行内式

      This is baidu
      baidu

        Code:
        This is [baidu](http://www.baidu.com/ "度娘")
        [baidu](https://www.baidu.com/)
      
    • 参考式

      This is baidu example reference-style link.

        Code:
        This is [baidu example][id] reference-style link.
        标记: [id]: https://www.baidu.com/ "度娘"
        或者: [id]: https://www.baidu.com/ '度娘' (简书不支持)
        或者 [id]: https://www.baidu.com/ (度娘)
        (简书不支持使用对文本描述使用单引号)
      
    • 隐式链接标记功能

      Baidu

        Code:
        [Baidu][]
        标记可以这样写: [Baidu]: http://baidu.com
      
    • 参考式链接范例:


         --I get 10 times more traffic from [Google] [1] than from 
         --[Yahoo] [2] or [MSN] [3]. 
         --[1]:  http://google.com/        "Google"
         --[2]: http://search.yahoo.com/  "Yahoo Search"
         --[3]: http://search.msn.com/    "MSN Search"
         --I get 10 times more traffic from [Google][] than from
         --[Yahoo][] or [MSN][].
         --[google]: http://google.com/        "Google"
         --[yahoo]:  http://search.yahoo.com/  "Yahoo Search"
         --[msn]:    http://search.msn.com/    "MSN Search"
         (备注: 上述代码在使用时需删掉前面的--)          
    
  8. 强调

    Markdown使用性星号(*)和底线(_)作为标记强调字词的符号
    两端被一个*或_包围的单词会被转换成斜体
    两端被两个*或_包围的单词会被转换成粗体
    *或_的两端不能有空白
    用什么符号就以什么符号结尾

     示例
     *斜体*
     _斜体_
     **粗体**
     __粗体__
    
  9. 代码

    如果要标记一段行内代码,可以用反引号 ` 把它包起来
    用多个反引号来开启和结束代码区段

    行内
    段落代码
    包含`反引号
    包含 `两个反引号`
    <特殊符号&>

     示例:
    
     ``段落代码``  
     ``包含`反引号``
     ``包含 `两个反引号` `` 
     ``<特殊符号&>``
    
  10. 图片
    Markdown使用一种和链接很相似的语法来标记图片
    允许两种样式:行内式和参考式

    • 行内式的图片语法:

      Overload 仓助
      Overload 仓助
        示例
          ![Overload 仓助](http://img4.duitang.com/uploads/item/201508/19/20150819131018_vYPyR.thumb.224_0.png   ) 
          ![Overload 仓助](http://img4.duitang.com/uploads/item/201508/19/20150819131018_vYPyR.thumb.224_0.png "森林贤王") 
      
    • 参考式语法:

      Overload 仓助
      Overload 仓助
        示例:
          -- ![Overload 仓助][xd]  
          -- [xd]:img4.duitang.com/uploads/item/201508/19/20150819131018_vYPyR.thumb.224_0.png  "森林贤王"
         (备注: 上述代码在使用时需删掉前面的--) 
      
  11. 转义

    使用反斜杠来插入一些在语法中有其它意义的符号,如*
    需要转义的字符:

    \   反斜线
    `   反引号
    *   星号
    _   底线
    {}  花括号
    []  方括号
    ()  括弧
    #   井字号
    +   加号
    -   减号
    .   英文句点
    !   惊叹号
    

本文主要参考自 http://wowubuntu.com/markdown/

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 162,547评论 4 374
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,787评论 2 308
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 112,175评论 0 254
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,752评论 0 223
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 53,169评论 3 297
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 41,056评论 1 226
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,195评论 2 321
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,980评论 0 214
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,724评论 1 250
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,872评论 2 254
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,344评论 1 265
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,667评论 3 264
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,379评论 3 245
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,202评论 0 9
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,992评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 36,189评论 2 286
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,987评论 2 279

推荐阅读更多精彩内容