For historical reasons, we still have a large number of *.confluence
files in the old Confluence 3.5 markup format. This format is not very useful (e.g. no editor support, no repository viewer support, ...), so I want to convert the files to markdown.
So how can I convert Confluence 3.5 markup to markdown?
The best solution I have found so far is the following, partially manual process:
The key idea in this solution is to convert the old Confluence markup to the new Confluence XML-based storage format first. Once converted to XML, further conversions are reasonably easy (assuming you know XSLT) and quite robust.
I also tried out the Node-base confluence2markdown converter, but the converter fails to parse the Confluence markdown reliably.
So using Atlassian tooling for parsing the Confluence markup seems to be the way to go. This step can probably be further automated by using the Atlassian SDK, but I haven't explored this option yet.