nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

How to import hundreds of .md files

Kevin Gaspard

Hello,

my company just had his own Confluence and we would like to migrate hundreds of .md pages from our actual wiki.

After a few tests I was able to add manually one of our page by pasting the markdown source code to generate a nice looking formatting. It works and it's fine, but we need to do it as fast and easily as we can, without waste of time for humans.

Our first guess would be to have access to a page where we can drag'n'drop the hundreds of page or a FTP/sFTP access to do the same thing. But I'm not sure this is possible.

What's the quickest way to do that please? Do you have a piece of advice for us?

Regards,

Kévin GASPARD

Accepted answers

All comments

Thomas Deiler_db00h3

Dear @Kevin Gaspard,

I do not know your format ".md", but I would give it a try with the REST API.

So long

Thomas

Thomas Deiler_db00h3

The REST call

POST https://myconfluence.com/rest/content

The JSON payload:

{

 "type":"page",
 "title":"A new page",
 "space":{"key":"ABC"},
 "body":{"
       storage":{
            "value":"place your .md content per page here",
            "representation":"storage"
       }
    }
}

Per new page, one call.

Kevin Gaspard

Thanks for that quick answer !

FYI, the .md is the file extension for Markdown: https://fileinfo.com/extension/md

We'll take a look at this, but if someone else have an other idea that would be welcome.

Regards,

Kévin GASPARD

Thomas Deiler_db00h3

Dear @Kevin Gaspard,

that seems to be easy. If you have one .md file per page, than you can just loop with a script over all files and fire one request.

My estimation for that script would be 1-2 hours writing, including testing on a test environment, first. Then the import of 1000 pages will not take longer than a couple of minutes.

So long

Thomas

Bill Bailey

To help you out, we stumbled across this package for Python:

https://github.com/pushrodtechnology/PythonConfluenceAPI

Stephen Deutsch

Hi Kevin,

I stumbled across this question, and it seems like the method that has been described to you won't work so well on its own, as you would have to convert the markdown format to storage format first before importing it as the page code, otherwise you would just get a page with the text of the markdown instead of a nicely formatted document.

Luckily, you don't have to go through all that, because Atlassian has a marketplace app that makes importing pages into Confluence Cloud really easy. It's called the Confluence Universal Importer and could import all your markdown files in one go, and it's free.

Michael Barbulescu

unfortunately Confluence Universal Importer tells "Looks like you took a wrong turn",
so try this filter

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

import

markdown

sftp

ftp