Software Documentation Tools之Markdown

Markdown is a lightweight markup language with plain text formatting syntax designed so that it can be converted to HTML and many other formats using a tool by the same name. Markdown is often used to format readme files, for writing messages in online discussion forums, and to create rich text using a plain text editor.

概括一句话：“Markdown的目标是实现「易读易写」。”

人性化设计

Markdown的语法全由标点符号所组成，并经过严谨慎选，是为了让它们看起来就像所要表达的意思。像是在文字两旁加上星号，看起来就像强调。Markdown的清单看起来，嗯，就是清单。假如你有使用过电子邮件，区块引言看起来就真的像是引用一段文字。

Markdown与HTML的关系

Markdown的语法有个主要的目的：用来作为一种网路内容的写作用语言。

Markdown不是要来取代HTML，甚至也没有要和它相似，它的语法种类不多，只和HTML的一部分有关系，重点不是要创造一种更容易写作HTML文件的语法，我认为HTML已经很容易写了，Markdow的重点在于，它能让文件更容易阅读、编写。HTML是一种发布的格式，Markdown是一种编写的格式，因此，Markdown的格式语法只涵盖纯文字可以涵盖的范围。不在Markdown涵盖范围之外的标签，都可以直接在文件里面用HTML撰写。不需要额外标注这是HTML或是Markdown，只要直接加标签就可以了。

举例来说，在Markdown文件里加上一段HTML表格：

This is a regular paragraph.

Foo

This is another regular paragraph.

关于Markdown的使用方法可以参考这里。