xdays

Markdown官方文档

说明

本文翻译自官方的英文文档,主要目的是个人学习Markdown语法和锻炼英语能力。

注意: 这篇文档本身就是用Markdown写的,你可以 在URL中添加.text来查看源码.


概述

思想

Markdown置力于尽可能的易读写。

可读性是最终要的。一片用Markdown格式化的文档应该可以作为文本原样发布,不许要看上去已经被一些标签或者格式化指令标记。Markdown的语法受目前已有的文本转html的过滤器影响--包括Setext, atx, Textile, reStructuredText, Grutatext, and EtText--对Markdown语法影响最大的是email的文本格式

Markdown的语法是由标点符号组成,这些标点符号都是精心挑选的以便来表达他们本意。例如,围绕单词的型号看起啦就像是强调。列表看起来像是,哦,列表。甚至是块引用看起来就像是引用的文本,假设你曾经使用过邮件。

内联HTML

Markdown的语法是为了一个目的:用来编写web的一种格式。

Markdown不是HTML的替代品,也不像它。他的语法很少,仅对应于HTML的标签的子集。其重点不是制定一些更便捷的插入HTML标签的语法。在我看来,HTML标签已经很容易插入了。Markdown的重点在于更容易的读,写和编辑文章。HTML是一种发布格式;Markdown是一种 ...