比较和对比轻量级标记语言
请确定最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文档