Markdown 语法精简版

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。

  • 链接的添加,共有三种形式,Markdown支持相对链接。

    <链接> :这种形式只是简单的标出链接;
    [文字](链接 “标题”):给文字添加链接,其中标题是可选的;
    [文字][标记]:给文字添加链接,链接在下面的一个以[标记]开头的新行(一般是文章末尾)给出。或者直接以[文字][]这种形式编写,在下面的新行中使用[文字]:链接的形式声明链接。

  • 图片的添加:跟链接比起来,图片只是多了在前面多了一个叹号”!”。
  • 标题格式:Markdown提供了2种方式。

    第一种是在标题前面加上1~6个”#”表示”<h1>”~”<h6>”。
    第二种是在标题下面另起一行,输入四个以上的等号“=”来表示”<h1>”,输入四个以上的减号“-”来表示”<h2>”。

  • 粗体和斜体:用星号”*”或者下划线”_”

    一个表示斜体;
    两个表示粗体;
    三个表示粗斜体。

  • 引用内容:就是html标记的”<blockquote>”,只要在行首用右尖括号>就行了。如果要嵌套引用,那就多打几个>。
  • 原文输出:如果不想Markdown解释某些内容,有两种方式:

    第一个是转义为html的”<pre>”标签:要在要原样输出的内容前面加入至少4个空格或者1个tab的宽度;
    第二个是转义为”<code>”标签:给要输出的内容加上”`”号(就是esc下头那个键)。

  • 无序列表:在文字前面使用星号”*”、加号”+”、减号”-”中的任意一个,注意在这些符号后面要留一个空格。
  • 有序列表:在第一条前添加一个数字,后跟一个英文句点”.”。无论第一个条目前加的数字是什么,列表都会从1开始计数。
  • 转义符:”\”。只要给不希望被转义的字符前面加上\就可以了。
  • HTML实体:如果要在内容中输出”<”或者”&”符号,那么必须用[HTML实体][]代替。Markdown会把HTML的特殊符号直接翻译为HTML实体。
  • 换行符:Markdown中在一行的末尾使用两个以上的空格标示HTML中的一个换行符”<br/>”。
  • 段落:只要两行之间有一个空行,Markdown就会把它识别为一个段落。
    (青蛙在写这篇文章的时候发现,在列表之前一定要加入一个空行,要不然Markdown是不会把”*”识别为列表的。)
  • 水平线:使用三个以上的”*”或”-”来表示。这些星号跟减号之间可以用空格,如果减号没有空格,
    那它必须在单独的一个段落里,要不它会被识别为标题的。
  • 直接使用HTML标记:有些Markdown不支持的标签可以直接写HTML标记,例如表格。

引自:一挥的博客 http://www.cnblogs.com/yihuiso/archive/2011/04/13/minimarkdown.html

相关: