Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Is it possible to create a Confluence page by uploading a markdown file?

Corey
September 13, 2023

I used the Obsidian note-taking app for creating product requirements. The files the app produces are .md (markdown). I like the content I've created and the organization between files, but my team uses Confluence and won't switch to Obsidian. 

I want to avoid having to copy/paste the content of the markdown files into Confluence pages to share with my teammates because there are a lot of files. Uploading the files as attachments to a page is not useful because my teammates will have to open files individually. 

Is it possible to create a Confluence page from a markdown file? 

3 answers

1 accepted

1 vote
Answer accepted
Mikael Sandberg
Community Champion
September 13, 2023

Hi @Corey,

Welcome to Atlassian Community!

Yes, it is possible, but you would need an app in order to do it. There are multiple ones in the Marketplace. A couple of our engineering teams is doing this and we are using the Render Markdown app together with a script that extract the .md file in GitHub and generates pages for each repository.

Corey
October 30, 2023

Thanks @Mikael Sandberg . Not what I was hoping for, but I guess it's something I'll have to dig into further to figure out how to set it up for us. Thank you.

3 votes
Surya Anisetty
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
September 11, 2025

I just copied the preview content of the markdown (as opposed to markdown code), in a markdown viewer, and pasted in the confluence new UI. It worked flawlessly.

0 votes
jeckyl
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
May 15, 2026

I'm also one of the guys that have created a markdown to Confluence tool.

I really like the Material for MkDocs markdown format, and use it all the time in my everything-as-code development setup. So I like to recreate as much of the Material for MkDocs look and feel in Confluence, because Confluence is a good Developer Portal platform :).

I think I have something that is pretty feature complete, support almost any Material for MkDocs syntax - https://squidfunk.github.io/mkdocs-material/

I'm also going to ensure that my tool will support the next version (Zensical) when it comes out of beta :)

If this sounds interesting, have a look at my GitHub repo - https://github.com/jeckyl2010/mkdocs2confluence

If you find it useful, or lacking some features, please let me know.

Have an awesome day.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
TAGS
AUG Leaders

Atlassian Community Events