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

Jas*_*ith 90 documentation markup markdown restructuredtext textile

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

另请参阅:Markdown与ReStructuredText

Jas*_*ith 115

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

纺织品

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

降价

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

reStructuredText(AKA ReST)

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

  • 当我在Emacs中硬包装时,我对reStructuredText中的列表和段落没有任何问题.事实上,它们的功能与我期望的完全相同:-) (6认同)
  • 对于ReST的用户,http://sphinx.pocoo.org/看起来像是一个非常好的工具,用于大型树形结构的参考文档集合. (4认同)

dat*_*dat 31

你也可以考虑asciidoc

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

  • @Martin:多段列表项真的那么重要吗?如果您需要多个段落,标题/部分不会比列表更合适吗? (4认同)
  • 不幸的是,asciidoc对于包含多个段落的列表项具有可怕的语法:您必须将它们与仅包含加号的单行分开(是的,"+"). (2认同)

tec*_*cal 21

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


小智 5

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

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