Markdown+语法说明+(简体中文版).doc

NOTE:::这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色。此文档用Markdown语法编写,你可以到这里查看它的源文件。「繁体中文版的原始文件可以查看这里。」—******@rikuMarkdown语法说明(简体中文版)l概述l宗旨l兼容HTMLl特殊字符自动转换l区块元素l段落和换行l标题l区块引用l列表l代码区块l分隔线l区段元素l链接l强调l代码l图片l其它l反斜杠l自动链接l感谢lMarkdown免费编辑器概述宗旨Markdown的目标是实现「易读易写」。可读性,无论如何,都是最重要的。一份使用Markdown格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。Markdown语法受到一些既有text-to-HTML格式的影响,包括Setext、atx、Textile、reStructuredText、Grutatext和EtText,而最大灵感来源其实是纯文本电子邮件的格式。总之,Markdown的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像*强调*。Markdown的列表看起来,嗯,就是列表。Markdown的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。兼容HTMLMarkdown语法的目标是:成为一种适用于网络的书写语言。Markdown不是想要取代HTML,甚至也没有要和它相近,它的语法种类很少,只对应HTML标记的一小部分。Markdown的构想不是要使得HTML文档更容易书写。在我看来,HTML已经很容易写了。Markdown的理念是,能让文档更容易读、写和随意改。HTML是一种发布的格式,Markdown是一种书写的格式。就这样,Markdown的格式语法只涵盖纯文本可以涵盖的范围。不在Markdown涵盖范围之内的标签,都可以直接在文档里面用HTML撰写。不需要额外标注这是HTML或是Markdown;只要直接加标签就可以了。要制约的只有一些HTML区块元素――比如<div>、<table>、<pre>、<p>等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown的生成器有足够智能,不会在HTML区块标签外加上不必要的<p>标签。例子如下,在Markdown文件里加上一段HTML表格:这是一个普通段落。<table><tr><td>Foo</td></tr></table>这是另一个普通段落。请注意,在HTML区块标签间的Markdown格式语法将不会被处理。比如,你在HTML区块内使用Markdown样式的*强调*会没有效果。HTML的区段(行内)标签如<span>、<cite>、<del>可以在Markdown的段落、列表或是标题里随意使用。依照个人习惯,甚至可以不用Markdown格式,而直接采用HTML标签来格式化。举例说明:如果比较喜欢HTML的<a>或<img>标签,可以直接使用这些标签,而不用Markdown提供的链接或是图像标签语法。和处在HTML区块标签间不同,Markdown语法在HTML区段标签间是有效的。特殊字符自动转换在HTML文件中,有两个字符需要特殊处理:<和&。<符号用于起始标签,&符号则用于标记HTML实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是<和&。&字符尤其让网络文档编写者受折磨,如果你要打「AT&T」,你必须要写成「AT&T」。而网址中的&字符也要转换。比如你要链接到:+bird你必须要把网址转换写为:;q=larry+bird才能放到链接标签的href属性里。不用说也知道这很容易忽略,这也可能是HTML标准检验所检查到的错误中,数量最多的。Markdown让你可以自然地书写字符,需要转换的由它来处理好了。如果你使用的&字符是HTML字符实体的一部分,它会保留原状,否则它会被转换成&;。所以你如果要在文档中插入一个版权符号?,你可以这样写:©Markdown会保留它不动。而若你写:AT&TMarkdown就会将它转为:AT&T类似的状况也会发生在<符号上,因为Markdown允许兼容HTML,如果你是把<符号作为HTML标签的定界符使用,那Markdown也不会对它做任何转换,但是如果你写:4<5Markdown将会把它转换为:4<5不过需要注意的是,code范围内,不论是行内还是区块,<和&两个符号都一定会被转换成HTML实体,这项特性让你可以很容易地用Markdown写HTMLcode(和HTML相对而言,HTML语法中