Markdown语法说明

标签：

1. 概述
   • 宗旨:易读易写
   • 兼容html:<div>,<table>等标签在markdown里面都可以直接用.要制约的只有一些区块元素,要求:
     • 开始标签和结尾标签不能用空白符号来缩进
     • 必须在前面和后面加上空行,与其它内容分割开来
   • 特殊字符自动转换
     • 在html文件中,<必须转义成&lt;(less than),>必须转义成&gt;
     • &必须转义成&amp;(and multiply)
     • 当然,html中还有好几个类似的转义字符,在markdown里面可以直接写<,>和&这三个东西,而无需转义.其他的转义字符如@copy;markdown的处理方式份html是一样的,把它当做转义字符.
2. 区块元素
   • 段落和换行
     • 段落是由一个或者多个连续文本航组成的,它的前后要有至少一个空行.
     • 这意味着markdown支持段内换行,相当于插入换行符.
   • 标题
     • 有两种方式写标题
       • ---------和=======,减号表示二阶标题,等号表示一级标题
       • ###,六个#表示六级标题,一个#表示一级标题
   • 区块引用blockquote
     • 在每行前加几个>就表示缩进多少
     • 在每个句子前面加几个>就表示这句话缩进多少,只在段落开头加就表示这整个段落缩进多少
   • 列表
     • 无序列表用*+-三种符号都行
     • 有序列表只要是数字加点就可以,例如  3.  23423.markdown并不会在意数字是几,最终都是变成html的样子.
     • 列表项目可以包含多个段落,每个段落要缩进4个空格或者一个制表符.
     • 如果我想打2323.怎么办,答曰;2323\.
   • 代码区块
     • 相当于<pre><code>,在markdown中只需要缩进4个空格或一个制表符就行了.
     • 一个代码区块会一直持续到没有缩进的那一行（或是文件结尾).
     • 代码区块中，一般的 Markdown 语法不会被转换，像是星号便只是星号,不表示无序列表.
   • 分隔线
     • 三个以上星号,减号,下划线+中间可以有若干个空格

• 区段元素
  • 链接
    • 有两种:行内式和参考式
    • 直接用尖括号括起来就是链接

    • 要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

      This is [an example](http://example.com/ "Title") inline link.
      
      [This link](http://example.net/) has no title attribute.
      

      会产生：

      <p>This is <a href="http://example.com/" title="Title">
      an example</a> inline link.</p>
      
      <p><a href="http://example.net/">This link</a> has no
      title attribute.</p>

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

      This is [an example][id] reference-style link.
      

      你也可以选择性地在两个方括号中间加上一个空格：

      This is [an example] [id] reference-style link.
      

      接着，在文件的任意处，你可以把这个标记的链接内容定义出来：

      [id]: http://example.com/  "Optional Title Here"

    • 链接内容定义的形式为：

      • 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
      • 接着一个冒号
      • 接着一个以上的空格或制表符
      • 接着链接的网址
      • 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着

    • 下面这三种链接的定义都是相同：

      [foo]: http://example.com/  "Optional Title Here"
      [foo]: http://example.com/  ‘Optional Title Here‘
      [foo]: http://example.com/  (Optional Title Here)

    • 链接网址也可以用尖括号包起来：

      [id]: <http://example.com/>  "Optional Title Here"
      

      你也可以把 title 属性放到下一行，也可以加一些缩进，若网址太长的话，这样会比较好看：

      [id]: http://example.com/longish/path/to/resource/here
          "Optional Title Here"

  • 强调
    • • 一个星号或者一个下划线表示<em>
  • • • 两个星号或者两个下划线表示<strong>
      • 用什么符号开启强调,就用什么符号结束
      • 若要写*或者_,需要转义\*
      • 如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。
  • 行内代码
    • 用反引号,相当于<code></code>
    • 若要写出反引号,那就用
  • 图片
    • • Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。

      • 行内式的图片语法看起来像是：

        ![Alt text](/path/to/img.jpg)
        
        ![Alt text](/path/to/img.jpg "Optional title")

      • 参考式的图片语法则长得像这样：

        ![Alt text][id]
        

        「id」是图片参考的名称，图片参考的定义方式则和连结参考一样：

        [id]: url/to/image  "Optional title attribute

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

Markdown语法说明

标签：

原文地址：http://www.cnblogs.com/weidiao/p/4831113.html