Syntax 使用哪种Wiki文本语法或标记？

在我的个人知识库上工作。。。我想格式化我的文档，甚至在本地硬盘上使用wiki语法。有时我会将它们上传到（公司）维基，有时我会从那里下载它们。计划使用一些工具来支持此流程，并搜索我的知识库（文档）以备将来使用。显然，我希望降价与大多数兼容，最大限度地减少转换工作

所以我的问题类似于，但是

• 当我开始新的东西时，我应该使用什么wiki文本版本或标记（方言）？（即文档项目和wiki类型）
• 使用/认可最多的是什么
• 工具支持（编辑器或库）在哪里最好？相关程序。语言有Java、Ruby和Scala

---

不幸的是，尽管一些wiki（尤其是Atlassian的商业产品）正在朝着XHTML的方向发展，但wiki世界中几乎没有格式标准化

使用最广泛的维基软件是（维基百科的名声）。众所周知，Mediawiki的标记很难解析，但它已经存在并得到了广泛的应用，因此有很多方法可以在Mediawiki格式之间进行转换，也可以使用许多不同的在线和离线编辑器编辑内容

MediaWiki还有一个功能齐全的API，其中包含多种编程语言的大量客户端库（请参阅），例如Ruby。

没有公认的标准wikitext语言

是“跨不同wiki使用通用wiki标记语言”的一项努力。该规范有一个版本1.0，有几个版本实现了它。MediaWiki没有实现它

有大量的实现，并且似乎被大量使用

由于没有商定的标准，可能会根据用例选择语言。

（1）虽然有很多wiki标记，但我建议坚持使用定义良好的标记语言

只有3个规范定义明确的纯文本标记：

• 尝试定义强语法并标准化流行标记的常见扩展。大家都喜欢。非常面向HTML
• 是一致的标记框架和成熟的项目（从2001年开始！！）。如果您需要在核心规范中内置可扩展性、内联外部标记、生成HTML/PDF/docbook/等，这是您的选择。有几本书和许多软件项目是通过reStructuredText记录的。使用发布软件检查您是否可以使用离线JS搜索构建HTML
• 与StructuredText竞争，但缺乏内置可扩展性。它非常面向书本。有几本书是用Ascidoc写的

标记没有获得定义良好的规范，并且周围的社区很弱。我建议您考虑以上3个选项。

（2）你绝对应该坚持使用纯文本文件

支持所有上述格式的软件，能够为打印和在线出版提供高质量的输出

我坚持使用RST，因为我需要可扩展性和内联外部标记的能力（使用LaTeX的数学、使用graphviz/dot的图形、使用imagemagic的绘图，等等）

---

我在Emacs编辑器或bash/grep中搜索个人提示。出于广告目的，我在网上发布了我的提示，例如：

伙计们，我确信这里有一些维基导出；-）我们真的需要一个最终将它们统一起来的Wiki标准：因此，对于一个使用Wiki语法（例如模板或内容）的新项目，您会推荐MediaWiki格式吗？您的项目有多大？您确定首先需要Wiki吗？对于大多数低技术项目来说，像Google Docs这样打开了变更跟踪功能的东西实际上会做得更好。我想将文档保存为某种std格式，机器可读会很好，但仍然是纯文本，用户在文本编辑器中非常可读。这就是降价（即wiki语法）。应该是一些知识管理工具（开发中）的基础。