比较和对比轻量级标记语言[关闭]

Question

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

另见：Markdown versus ReStructuredText

Answer 1

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

Textile

• 由Redmine和Ruby社区使用
• 目前在Stack Overflow上标记了113个问题
• 最类似于HTML，但最不可读的来源
• 最容易嵌套的所有三种语言的列表
• 非程序员或HTML无知者无法理解
• 非常适合复杂的短文档（包含链接，嵌套列表，代码，自定义HTML）;例如：简短的文档，how-tos，博客或CMS内容
• Syntax reference

Markdown

• 似乎没有一个家庭语言“社区”，但......
• Stack Overflow上标记了1274个问题*
• 强调源代码可读性，类似于电子邮件传统
• 直接的HTML嵌入（你只需键入标签）
• 除了嵌入HTML之外，无法制作表格
• 如果你知道Stack Overflow，你就已经知道了
• 如果您已经了解reStructuredText，则易于学习
• 格式为<[email protected]>的自动电子邮件地址模糊处理（带尖括号）
• Syntax reference

reStructuredText (A.K.A. ReST)

• 在Python社区中很受欢迎
• Stack Overflow上标记了285个问题
• 如果你问我，有点空白和对齐
• 列表（尤其是嵌套列表）和段落似乎总是打架
• 非程序员可读
• 只有可以构建目录的格式（通过Python参考实现中的扩展）
• 直接转换为PDF和XML等其他格式
• 适用于包含大量散文的大型文档（例如，用户手册的docbook替代方案）
• Syntax reference

Answer 2

你也可以考虑asciidoc

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

Answer 3

lightweight markup languages上的维基百科页面对各种选项进行了很好的比较，并显示了常用的语法（标题，粗体，斜体等）

Answer 4

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

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片段之外，我更喜欢后者。表格，交叉引用，间接链接等......

Answer 5

用于文档？ doxygen怎么样？ 我已将它用于我需要记录的一些c / c ++项目。即使你可以“滥用”它就像doxygen作者用于doxygen文档一样