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

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

另请参阅:Markdown与ReStructuredText

1> JasonSmith..：

---

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

纺织品

由Redmine和Ruby社区使用

目前在Stack Overflow上标记了113个问题

最类似于HTML,但最不可读的来源

最容易嵌套的所有三种语言的列表

非程序员或HTML无知者无法理解

非常适合复杂的短文档(包含链接,嵌套列表,代码,自定义HTML); 例如:简短的文档,how-tos,博客或CMS内容

语法参考

降价

似乎没有一个家庭语言"社区",但......

Stack Overflow上标记了1274个问题*

强调源代码可读性,类似于电子邮件传统

直接的HTML嵌入(你只需键入标签)

除了嵌入HTML之外,无法制作表格

如果你知道Stack Overflow,你就已经知道了

如果您已经了解reStructuredText,则易于学习

格式为的自动电子邮件地址模糊处理(带尖括号)

语法参考

reStructuredText(AKA ReST)

在Python社区中很受欢迎

Stack Overflow上标记了285个问题

如果你问我,有点空白和对齐

列表(尤其是嵌套列表)和段落似乎总是打架

非程序员可读

只有可以构建目录的格式(通过Python参考实现中的扩展)

直接转换为PDF和XML等其他格式

适用于包含大量散文的大型文档(例如,用户手册的docbook替代方案)

语法参考

---

当我在Emacs中硬包装时,我对reStructuredText中的列表和段落没有任何问题.事实上,它们的功能与我期望的完全相同:-)

---

对于ReST的用户,http://sphinx.pocoo.org/看起来像是一个非常好的工具,用于大型树形结构的参考文档集合.

2> dat..：

---

你也可以考虑asciidoc

相对可读的标记

简单的命令行使用

有些人可能认为它在语法方面相对"挑剔"(相对于灵活)

docbook和(x)html输出

---

@Martin:多段列表项真的那么重要吗？如果您需要多个段落,标题/部分不会比列表更合适吗？

---

不幸的是,asciidoc对于包含多个段落的列表项具有可怕的语法:您必须将它们与仅包含加号的单行分开(是的,"+").

3> technomalogi..：

---

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

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