如何将旧Confluence 3.5标记转换为markdown？

Question

由于历史原因，旧的Confluence 3.5标记格式中仍有大量*.confluence个文件。这种格式不是很有用（例如没有编辑器支持，没有存储库查看器支持，......），所以我想将文件转换为markdown。

那么如何将Confluence 3.5标记转换为markdown？

Answer 1

到目前为止，我找到的最佳解决方案是以下部分手动过程：

1. 在当前版本的Confluence（5.x或更高版本）中创建一个空的wiki页面并保存。
2. 再次编辑页面。
3. 转到＆＃34;插入＆＃34; ＆GT; ＆＃34;标记＆＃34;并插入Confluence标记
4. 点击＆＃34;在源代码编辑器中打开＆＃34;以新的基于XML的存储格式显示内容
5. 将内容复制到XML文件
6. 添加缺少的页眉和页脚（请参阅https://github.com/highsource/confluence-to-markdown-converter/issues/8）
7. 使用c2md.xsl Github项目中的confluence-to-markdown-converter XSLT转换将XML文件转换为markdown。

此解决方案的关键思想是首先将旧的Confluence标记转换为新的基于Confluence XML的存储格式。一旦转换为XML，进一步的转换相当容易（假设你知道XSLT）并且非常强大。

我还尝试了基于节点的confluence2markdown转换器，但转换器fails to parse the Confluence markdown reliably。

因此，使用Atlassian工具解析Confluence标记似乎是要走的路。使用Atlassian SDK可能会进一步自动完成此步骤，但我还没有探索过此选项。