Markdown的语法有个主要的目的:用来作为一种网路内容的写作用语言。
Markdown不是要来取代HTML,甚至也没有要和它相似,它的语法种类不多,只和HTML的一部分有关系,重点不是要创造一种更容易写作HTML文件的语法,我认为HTML已经很容易写了,Markdow的重点在于,它能让文件更容易阅读、编写。HTML是一种发布的格式,Markdown是一种编写的格式,因此,Markdown的格式语法只涵盖纯文字可以涵盖的范围。
不在Markdown涵盖范围之外的标签,都可以直接在文件里面用HTML撰写。不需要额外标注这是HTML或是Markdown;只要直接加标签就可以了。
只有区块元素──比如<div>、<table>、<pre>、<p>等标签,必需在前后加上空行,以利与内容区隔。而且这些(元素)的开始与结尾标签,不可以用tab或是空白来缩排。Markdown的产生器有智慧型判断,可以避免在区块标签前后加上没有必要的<p>标签。
举例来说,在Markdown文件里加上一段HTML表格:
This is a regular paragraph. <table> <tr> <td>Foo</td> </tr> </table> This is another regular paragraph.
请注意,Markdown语法在HTML区块标签中将不会被进行处理。例如,你无法在HTML区块内使用Markdown形式的*強調*。
HTML的区段标签如<span>、<cite>、<del>则不受限制,可以在Markdown的段落、清单或是标题里任意使用。依照个人习惯,甚至可以不用Markdown格式,而采用HTML标签来格式化。举例说明:如果比较喜欢HTML的<a>或<img>标签,可以直接使用这些标签,而不用Markdown提供的连结或是影像标示语法。
HTML区段标签和区块标签不同,在区段标签的范围内,Markdown的语法是有效的。