由于历史原因,我们仍然有大量的*.confluence
文件采用旧的Confluence 3.5标记格式。这种格式不是很有用(例如,没有编辑器支持,没有存储库查看器支持,...),所以我想将文件转换为 markdown。
那么如何将 Confluence 3.5 标记转换为降价呢?
到目前为止,我找到的最佳解决方案是以下部分手动过程:
- 在当前版本的 Confluence(5.x 或更高版本)中创建一个空的 wiki 页面并保存。
- 再次编辑页面。
- 转到"插入">"标记"并插入 Confluence 标记
- 单击"在源代码编辑器中打开"以新的基于 XML 的存储格式显示内容
- 将内容复制到 XML 文件
- 添加缺少的页眉和页脚(请参阅 https://github.com/highsource/confluence-to-markdown-converter/issues/8)
- 使用 c2md.xsl XSLT 转换从 confluence-to-markdown 转换器 Github 项目将 XML 文件转换为 markdown。
此解决方案中的关键思想是首先将旧的 Confluence 标记转换为新的基于 Confluence XML 的存储格式。一旦转换为 XML,进一步的转换就相当容易(假设您了解 XSLT)并且非常健壮。
我还尝试了 Node-base confluence2markdown 转换器,但转换器无法可靠地解析 Confluence markdown。
因此,使用 Atlassian 工具解析 Confluence 标记似乎是要走的路。此步骤可能可以通过使用 Atlassian SDK 进一步自动化,但我尚未探索此选项。