MarkDown语法

    xiaoxiao2025-04-08  7

    Markdown的目标是实现易读易写.

    Markdown语法的目标是:成为一种适用于网络的书写语言.

    兼容HTML特殊字符自动转换

    兼容HTML

    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实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是&lt;和&amp;。

    &字符尤其让网络文档编写者受折磨,如果你要打「AT&T」,你必须要写成「AT&amp;T」.而网址中的&字符也要转换,比如你要链接到:

    http://images.google.com/images?num=30&q=larry+bird

    你必须要把网址转换写为:

    http://images.google.com/images?num=30&amp;q=larry+bird

    才能放到链接标签的href属性里。不用说也知道这很容易忽略,这也可能是HTML标准检验所检查到的错误中,数量最多的.

    Markdown让你可以自然地书写字符,需要转换的由它来处理好了.如果你使用的&字符是HTML字符实体的一部分,它会保留原状,否则它会被转换成&amp;.所以你如果要在文档中插入一个版权符号©,你可以这样写:

    &copy;

    Markdown会保留它不动。而若你写:

    AT&T

    Markdown就会将它转为:

    AT&amp;T

    类似的状况也会发生在<符号上,因为Markdown允许兼容HTML,如果你是把<符号作为HTML标签的定界符使用,那Markdown也不会对它做任何转换,但是如果你写:

    4 < 5

    Markdown将会把它转换为:

    4 &lt; 5

    不过需要注意的是,code范围内,不论是行内还是区块,<和&两个符号都一定会被转换成HTML实体,这项特性让你可以很容易地用Markdown写HTML code(和HTML相对而言,HTML语法中,你要把所有的 <和&都转换为HTML实体,才能在HTML文件里面写出HTML code)

    转载请注明原文地址: https://ju.6miu.com/read-1297848.html
    最新回复(0)