First, select Confluence cube you want to import data into 1. Then specify to which column you would like to map the imported data. You will need it later to import your Confluence data into your new database. Make a copy of the Confluence Home and other important directories. Find the latest information on the improvements made in the new Confluence Cloud editor.

I recently did some investigations at work on how to keep documentation up to date. I guess we’ve all been in the situation that the documentation we have is drifting from how the actual systems/applications look like. I believe that it’s easier to keep the documentation close the the actual code, e.g by README’s in markdown, than by have them as separate confluence pages that no one remembers to keep up to date. If you are using Confluence you can create/update documentation by using the REST api, however Confluence does not accept markdown so you have two options;

• install markdown plugins (that’s available in the api)
• or convert markdown to confluence markup language

Confluence Wiki Import Markdown

I went with the latter options since that felt a bit easier. I found this ruby gem. Unfortunately it’s installed as a gem with dependencies you might not have available and it only runs as a cli-tool which might not be ideal if you want to include this as a step in your CI/CD pipeline. I quickly hacked together a way to run this gem as a REST server instead inside a docker container, which eliminates bothersome dependencies and make’s it easier to include in your pipeline.

Quick Tutorial

• Run the container by pulling the image from docker hub:

Confluence Markdown Syntax

• Test the conversion (example script in ruby)

Asciicast Demo

Confluence Import Markdown

Complete Example

Confluence Api Import Markdown

Confluence Markdown Code

If you want to check out the complete source code you can take a look at this repo and follow the README.