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

请确定最stream行的轻量级标记语言,并比较它们的优缺点。 这些语言应该是技术散文的通用标记,例如文档(例如,Haml不计数)。

另请参阅: Markdown与ReStructuredText

我知道更多的编程和技术社区通常使用三种主要语言:Textile,Markdown和reStructuredText。 所有这三个都可以在几个小时内学到,或者在附近的备忘单上“飞过”。

纺织品

  • 由Redmine和Ruby社区使用
  • Stack Overflow当前标记为113个问题
  • 最类似于HTML,但最不可读的来源
  • 所有三种语言的最简单的嵌套列表
  • 对于非程序员或无知的HTML来说是不可理解的
  • 适用于复杂的短文档(包含链接,嵌套列表,代码,自定义HTML); 例如:短文档,how-to,博客或CMS内容
  • 语法参考

降价

  • 似乎没有一个母语“社区”,但…
  • 1274堆栈溢出标记的问题*
  • 强调源代码的可读性,类似于电子邮件的传统
  • 简单的HTMLembedded(你只需input标签)
  • 除了embeddedHTML之外,没有办法制作表格
  • 如果你知道堆栈溢出,你就知道了
  • 如果您已经知道reStructuredText,那么容易学习
  • 自动电子邮件地址混淆格式为<address@example.com>(带尖括号)
  • 语法参考

reStructuredText(又名ReST)

  • 在Python社区中很受欢迎
  • Stack Overflow标记了285个问题
  • 如果你问我的话,你可能会对空白和alignment有一点胡言乱语
  • 列表(特别是嵌套列表)和段落似乎总是打架
  • 非程序员可读
  • 只有格式可以build立一个目录(通过Python参考实现中的扩展)
  • 直接转换为其他格式,如PDF和XML
  • 理想的散文大量文件(例如用户手册docbook的替代)
  • 语法参考

你也可以考虑asciidoc

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

维基百科页面上的轻量级标记语言在各种选项之间有很好的比较,并且显示了常用的语法(标题,粗体,斜体等)

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

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

正如你所看到的,它开始于“我怎样才能build立一个安全的博客” – 即生成静态的HTML,我发现自己陷入了标记语言,模板系统等等。

更新

我只重点关注用python实现的LWML,他们在这里:

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

到目前为止,我已经尝试了降价和ReST,我喜欢后者更好的除了embedded在其他页面的HTML片段。 表,交叉参考,间接链接等…

为文档? doxygen呢?
我用它来做一些我需要documentize的c / c ++项目。 即使你可以“滥用”它就像doxygen作者用于doxygen文档