韩雨 / Markdown语法
Created 2012-11-22 Modifyed 2012-11-22

1255 Words

思维导图文件下载

致谢

  • 站在这位 巨人 的肩膀上

直接使用HTML

  • 一般来说直接使用

  • 特殊:块标签必须在前后加上空白,例如:div,table,pre,p

  • 注意:块标签中的MD语法无效,而段标签中有效,例如:span,cite,del

特殊字符处理(<&)

  • 可以直接使用

  • 在code范围内转换为&lt;&amp;

段落

  • 一个以上相连接的句子组成

换行

  • 一个以上的空行会转化为p

  • 如果想要br换行,必须在行尾加上2个以上空白再回车

标题

  • 底线形式(Setext)

      在标题文字后另起一行,写上特殊符号
    
      一阶标题用`=`,二阶标题用`-`
    
      符号数量随便
    
  • Atx形式

      在标题文字行首加入1到6个`#`,代表1到6阶
    
      注意:`#`后必须加一个空格
    

引用文字

  • 在段落的第一行或者每行前面加上>

  • 可以有层次,只要根据层数加上不同数量的>

  • 可以使用其他md语法,比如标题、清单和程序区块等

清单

  • 无序

      在行首添加*或+或-再加上空格
    
  • 有序

      数字加英文句号加空格
    
      数字不影响顺序,最好从1开始(方便写作过程中调整语句顺序后忘记修改数字编号)
    
  • 可以包含段落

      段落必须缩排4个空格/1个tab
    
  • 可以包含引言

      引言的符号`>`必须缩排4个空格/1个tab
    
  • 可以包含程序

      必须缩排8个空格/个tab
    
  • 如果不想使用分块,但是又必须出现数字+句号,那么在句号前加反斜杠”"

链接

  • 行内

      直接把文字和URL写在一行中
    
      方括号把文字括起来,后面紧跟小括号把URL括起来
    
      例如:This is [an example](http://example.com/ "Title")
    
  • 参考

      URL统一定义,文字后跟的是ID
    
      第一个方括号把文字括起来,后面紧跟第二个方括号把id括起来
    
      例如:This is [an example][id] reference-style link.
    
      id可以放在文章任意地方(建议放在末尾),方括号把id括起来+冒号+空白+url+双引号/小括号括起来title内容。如果title太长,可以放到下一行。例如:[id]: http://example.com/ "Optional Title Here"
    
      省略用法:如果文字和id一样,那么在第二个括号中就不要写id了。留一个空括号。例如:[Google][]            [Google]: http://google.com/
    

图片

  • 行内

      感叹号+方括号把图片替代文字括起来+小括号把URL括起来+空格+双引号括起来的title文字
    
      例如:![Alt text](/path/to/img.jpg "Optional title")
    
  • 参考

      感叹号+第一个方括号把文字括起来+第二个方括号把id括起来
    
      例如:![Alt text][id]
    
      id可以放在文章任意地方(建议放在末尾),方括号把id括起来+冒号+空白+url+双引号/小括号括起来title内容。如果title太长,可以放到下一行。例如:[id]: http://www.taosteel.com/static/images/logoTaosteel.gif "Optional title attribute"
    

分隔线

  • 在一行中用三個或以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號中間插入空白

程序代码

  • 缩排4个空白/1个tab

  • md语法不会被转换

  • 如果标记一小段可以用反引号包起来,如果要显示反引号,那么在前后放入一个空格,然后用多个反引号包围

强调

  • *_包围的文字,符号必须成对出现

  • 一对符号转译为em(斜体),二对符号转译为<strong>

自动链接

用反斜杠来插入特殊符号