89

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

另请参阅：Markdown 与 ReStructuredText

4

5 回答 5

115

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

纺织品

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

降价

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

reStructuredText (AKA ReST)

  • 流行于 Python 社区
  • 在 Stack Overflow 上标记了 285 个问题
  • 如果你问我，对空格和对齐有点挑剔
  • 列表（尤其是嵌套列表）和段落似乎总是打架
  • 非程序员可读
  • 唯一可以构建目录的格式（通过 Python 参考实现中的扩展）
  • 直接转换为其他格式，如 PDF 和 XML
  • 非常适合包含大量散文的大型文档（例如，作为用户手册的 docbook 的替代品）
  • 语法参考
于 2009-03-18T17:21:29.517 回答
32

你也可以考虑asciidoc

  • 相对可读的标记
  • 直接的命令行使用
  • 有些人可能会认为它在语法方面相对“挑剔”（相对于灵活）
  • docbook 和 (x)html 输出
于 2009-05-25T22:52:45.913 回答
21

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

于 2010-07-27T14:20:56.530 回答
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 片段之外，我更喜欢后者。表格、交叉引用、间接链接等...

于 2010-06-08T13:18:58.470 回答
4

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

于 2009-07-18T16:45:24.300 回答