比较和对比轻量级标记语言

请确定最流行的轻量标记语言，并比较它们的优缺点。这些语言应该是技术散文（例如文档）的通用标记（例如，Haml不计算在内）。

另请参阅：Markdown与ReStructuredText

我知道大型编程和技术社区中常用的三种主要语言：Textile，Markdown和reStructuredText。可以在几个小时内学会全部三个，也可以在附近的备忘单上“飞翔”。

纺织品

• 由Redmine和Ruby社区使用
• 当前在Stack Overflow上标记的113个问题
• 与HTML最相似，但可读性最低
• 三种语言的最简单的嵌套列表
• 非程序员或对HTML不了解的人无法理解
• 非常适合复杂的简短文档（带有链接，嵌套列表，代码，自定义HTML）；例如：简短文档，操作方法，博客或CMS内容
• 语法参考

降价促销

• 似乎没有母语“社区”，但...
• 在Stack Overflow *上标记了1274个问题
• 强调源代码的可读性，类似于电子邮件传统
• 简单的HTML嵌入（您只需键入标签即可）
• 除了嵌入HTML之外，无法制作表格
• 如果您知道堆栈溢出，就已经知道了
• 如果您已经知道reStructuredText，就很容易学习
• 自动电子邮件地址混淆，格式为<address@example.com>（带尖括号）
• 语法参考

reStructuredText（又名ReST）

• 在Python社区中很受欢迎
• 堆栈溢出标记了285个问题
• 如果您问我一些关于空格和对齐的定论
• 列表（尤其是嵌套列表）和段落似乎总是很吵
• 非程序员可读
• 唯一可以建立目录的格式（通过Python参考实现中的扩展）
• 直接转换为其他格式，例如PDF和XML
• 非常适合散文繁多的大型文档（例如，用户手册的docbook的替代品）
• 语法参考

您也可以考虑使用asciidoc

• 相对可读的标记
• 命令行直接使用
• 在语法方面，有些人可能认为它相对“挑剔”（相对灵活）
• docbook和（x）html输出

轻量级标记语言的Wikipedia页面在各种选项之间进行了很好的比较，并显示了常用语法（标题，粗体，斜体等）。

我试图在这里介绍所有各种轻量级标记语言：

http://www.subspacefield.org/~travis/static_blog_generators.html

如您所见，它始于“如何创建一个安全的博客”，即生成静态HTML的博客，我发现自己陷入了标记语言，模板系统等问题。

更新资料

我只专注于具有python实现的LWML，它们在这里：

http://www.subspacefield.org/~travis/python_lightweight_markup_languages.html

到目前为止，我已经尝试了markdown和ReST，除了其他网页中嵌入的HTML代码段外，我更喜欢后者。表格，交叉引用，间接链接等...

用于文档？氧气怎么样？
我已经将它用于一些需要记录的c / c ++项目。甚至您也可以“滥用”它，就像doxygen作者用于doxygen文档一样