How to import pages with markdown format into Confluence?
Asked by Chandra Sekhar pydi RAJU boni:

Hi All -

We have an external application "moinmo" having some 1000+ pages stored in markdown format.

Due to outage of license we want to migrate these pages to my already up and running confluence instance (sever instance).

My question is - Do confluence support markdown format file while importing pages to the site?

If yes, how to do this? Please help me over this.

Thanks

Chandra


Answers:
author: Laura Holton _ACE Rotterdam_
body: Hi [@Chandra Sekhar pydi RAJU boni](/t5/user/viewprofilepage/user-id/4672621) ?

Welcome to the Community! This is certainly possible with [Confluence Wiki Markup](https://confluence.atlassian.com/doc/confluence-wiki-markup-251003035.html)...

Confluence supports inserting content in markdown. This is often used in ReadMe files. See [Markdown syntax guide](https://confluence.atlassian.com/bitbucketserver/markdown-syntax-guide-776639995.html) for some examples of markdown syntax.

**To insert markdown in the editor:**

1. Choose **Insert** \> **Markup**
2. Select **Markdown**
3. Type or paste your text - the preview will show you how it will appear on your page
4. Choose **Insert**.

As with wiki markup, Confluence will convert your markdown to the rich text editor format. You will not be able to edit your content using markdown.

I hope this helps but if you have any other questions just ask away ?

All the best,

Laura

comments: author: Chandra Sekhar pydi RAJU boni
body: Hi [@Laura Holton _ACE Rotterdam_](/t5/user/viewprofilepage/user-id/2568325) -

Thanks for your quick reply.

We have this 1k+ pages and they will be exported as markdown file.

It means all these 1k+ pages will be scripted in one single markdown file and these markdown file is to be imported into our confluence.

So, i'm looking for this process.

Thanks

Chandra


author: Pablo LION
body: Hi [@Laura Holton _ACE Rotterdam_](/t5/user/viewprofilepage/user-id/2568325)

I tried follow the "Insert \> Markup" yet I see nothing. Where should I find it?

Thanks.

P.S. This is the screenshot

![image.png](https://community.atlassian.com/t5/image/serverpage/image-id/183400i3558E32B9703A84A/image-size/large?v=v2&px=999 "image.png")


author: max_fung
body: Had the same issue finding this.


author: Pablo LION
body: [@max_fung](/t5/user/viewprofilepage/user-id/4781222) That page was for Confluence V4 and seems we are in V5 now. So it doesn't apply. I found two ways to do it:

- Generate a rich text (like VScode preview, the built-in one is fine here, or simply an HTML), then copy the rich text to the confluence. This would keep most of the format.   
- Or use [https://marketplace.atlassian.com/apps/1211438/markdown-macro-for-confluence?hosting=cloud\&tab=pricing](https://marketplace.atlassian.com/apps/1211438/markdown-macro-for-confluence?hosting=cloud&tab=pricing) (I didn't test yet)


author: liang.ma
body: Same issue, so one year passed, and there is still no good solution for this?


author: Jeremy Reed
body: Using the built-in Markup import is garbage. It only captures half of the formatting at best, then I have to spend time reformatting all of my code blocks, block quotes, etc, because it ignores all of that.


author: bcdubs
body: What on earth is the point of this software if you can't import the files you want to organise? Is this some sort of a joke or what?


author: Nar Kumar C. - Narva Software
body: Hi everyone,

Like others mentioned, Confluence does not support importing files directly. You can however paste the content to the editor, and it converts Markdown to Confluence format after pasting, though that is not always desirable or ideal.

We recently released an app which solves this problem: [**Markdown for Confluence - Native Markdown Editor**](https://marketplace.atlassian.com/apps/1231324/markdown-for-confluence-native-markdown-editor?hosting=cloud&tab=overview&utm_source=community&utm_medium=referral&utm_content=1886974)

With this app, simply open the Markdown editor and paste the content you want to import. You can also edit the pages afterward using Markdown.

Hope this app will be helpful. Let us know if you have any feedback.


author: Fabian Lim
body: Hi [@Chandra Sekhar pydi RAJU boni](/t5/user/viewprofilepage/user-id/4672621)

This is possible using the markup macro and then inserting a markdown. Here are the instructions: <https://confluence.atlassian.com/doc/confluence-wiki-markup-251003035.html>

Regards

comments: author: Chandra Sekhar pydi RAJU boni
body: [@Fabian Lim](/t5/user/viewprofilepage/user-id/3131564) ,

Hi - THis is useful but not in my case.

I want to import pages using a markdown format file not to insert things in confluence pages in markdown format.

Please suggest in that.

Thanks for your link and help

Chandra


Tags: atl-gruland

confluence-server

server