Markdown 语法说明

概述

宗旨

Markdown 的目标是实现「易读易写」
可读性,无论如何,都是重要的。一份使用Markdown 格式撰写的文件应该可以直接以纯文本格式发布,并且看起来不会像是由许多标签或者格式指令所构成。Markdown 语法收到一些既有text-to-HTML 格式的影响,包括SetextatxTextilereStructuredTextGrutatextEtText,而最大灵感来源其实是纯文本电子邮件的格式。
总之,Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像强调。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引用开起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。

兼容HTML

Markdown 语法的目标是:成为一种适用于网络的书写的格式。就这样,Markdown 的格式语法只涵纯文本可以涵盖的范围。
不在Markdown 涵盖范围之内的标签,都可以直接在文档里面用HTML撰写。 不需要额外标注这是HTMl或者是Markdown;只要直接加标签就可以了。
要制约的只有一些HTML区块元素--比如 、、、 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结束标签不能用制表符或者空格来缩进。Markdown 的生成器有足够智能,不会在HTML区块标签外加上不必要的``标签。
例如如下,在Markdown文件里加上一段HTML表格:

这是一个普通段落。
<table>
     <tr>
         <td>Foo</td>
    </tr>
</table>
这是另一个普通段落。

请注意,在HTML区块标签间的Markdown格式语法将不会被处理。比如,你在HTML区块内使用Markdown样式的强调会没有效果。
HTML的区段(行内)标签如、、~~~~ 可以在Markdown的段落、列表或是标题里随意使用。按照个人习惯,甚至可以不用Markdown的格式,而直接采用HTML标签来格式化。举例说明:如果比较新欢HTML的或标签,可以直接使用这些标签,而不用Markdown提供的链接或是图像标签语法。
和处在HTML区块标签间不同,Markdown语法在HTML区段标签间是有效的。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容