According to the Confluence documentation on http://Importing Content Into Confluence, there is no supported way of importing markdown. Is this the case?
3rd party solutions seem not to work with current, self-hosted versions.
There are a number of ways.
A. To insert markdown in the editor:
B. Use the Mardown macro which renders Markdown from a URL
C. Use HTML Macro
For me the Insert/Markup(Markdown) Macro sometimes works as expected, but sometimes *not at all* (maybe with too large contents, or missing new lines ??)
If it's not working, trying to fix it in the form also often fails (vs fixing in external editor, and re-copy&pasting into the form)
IMO It would be great if that tool would be more powerful and robust. At least providing some 'reparse' button (in case the live editing is too tricky for large contents') or maybe it could give some hints, about issues detected while parsing the MD?!
The macro doesn't seem to exist anymore, neither does there exist an "Insert" menu anymore. When I copy *some* HTML from a page, some of it imports correctly, but things like `abc_*_foo` turn into bullet points... And when I paste the whole content, the editor acts like the clipboard is empty.
This solution may not work for everyone, but I wrote a tool to do just this. It takes a markdown file and uploads it to confluence. I use it to sync my notes daily. It's not perfect, but it works: https://github.com/justmiles/go-markdown2confluence
in days where markdown is basically the goto language for documentation of developers, not supporting it is insane.
Everyone here around me hates confluence, our devs write docs in markdown or, preferably, asciidoctor.
The management insists of having documents in confluence. And no, we can not install addons since this is done by different division/people and it requires process no one wants to go. A quite common situation.
So guess what, confluence gets more and more negative feelings. All the mentioned work arounds are crap. It seams Atlassian is on a suicide trip by making developers hating their solution.
I agree. In our organization we have some users who like Confluence and we are keeping some of our documents there. The problem is much of my work includes documents using Markdown format. I find it hard to believe that Markdown is not supported out of the box.
Lead S/W Engineer
Indeed, copying the rendered Markdown (p.eg from VS-code "Markdown Preview") works *quite* well, BUT/except code blocks (rendered via ``` code ``` sections) are not properly migrated (just as normal text)
Does anybody know a way to also get code-blocks migrated (in a MD file)?
Using pandoc, I just converted a page of Markdown (exported from the Notion app) into org-mode (an Emacs organizer/markup/task-management/everything "app"), and then used an export module to export that page to JIRA (Confluence) format. I could then paste that into a comment.
I wouldn't recommend it as a regular thing, but it did the job in this case, and I'm fairly fluent in all three markup languages, so I could fix something if it broke along the way.
These are the markdown add-ons that support server installations. Of these, the only one that appears to do something close to an import is Marked, which is free and has very good reviews. It allows you to point to a markdown file and show it in a Confluence page.
If this is a one time transfer of .md files, you might want to consider spinning up a free trial version of Confluence Cloud, installing the trial version of one of the Cloud markdown import add-ons (e.g. Confluence Pandoc), performing the import and then exporting the space and importing it into your server instance. (I've never tried this, so I don't know if it's possible, but it's worth exploring if you've got a large amount to import.)
If you you have intermediate familiarity with Python, you may be able to create a simple utility that takes as input a MarkDown file, and creates a Confluence page (as a child of an existing ancestor) that is consistently styled. The utility will use Confluence Remote API, Python Requests, and Python Markdown.
Here are some resources for you:
Python Requests: http://docs.python-requests.org/en/master/
Python Markdown: http://pythonhosted.org/Markdown/
Confluence Server REST API: https://developer.atlassian.com/confdev/confluence-server-rest-api
The Page Information link is there because the Confluence Server REST API uses Page IDs, and you can use the Page Information menu item to obtain the Page ID of the Confluence page you're viewing.
We released an add-on which allows importing documents from different file formats like Markdown, Word, ODT and many others: All-in-one File Importer for Confluence
Please give it a try and give us feedback if you see any issues. You can install from here:
Currently this add-on works on Confluence cloud. If there is enough interest from Atlassian community, we are more than happy to release server version.
We've been long-time users of Confluence. Personally I've always been frustrated with the WYSIWYG editor.
But then again, I've yet to see any product or plugin for any platform, successfully crack the web-based WYSIWYG editor nut. You'd think by now someone would have. But once you get to a certain level of formatting complexity, Confluence and every other web-based WYSIWYG editor starts soiling the bed. (E.g. in the case of Confluence, at some point you can't position the cursor with the keyboard, without skipping over entire sections. Or formatting one section will format whole chunks or even the entire document, the same way. Again - not unique problems to Confluence.) I think part of the problem is that if you make the mistake of changing the formatting of a section (e.g. to bullets and back to normal paragraph), rather than replacing formatting directives, it keeps adding them...in ways that confuses itself. If web-based WYSIWYG editors would just do self-linting, that would probably be a big help.
It's similar to the problem of exporting a Word document to HTML. Even if you choose "simplified", the HTML is an absolute rat's nest. Running it through HTMLTidy is usually the only way to turn it into sensible HTML, but even that's often not enough.
When we (and specifically I) really started using Markdown, it was like a revelation. Finally, a way to do reasonably sophisticated formatting in a way that you have total control over the formatting directives, and it never gets confused. I use Markdown everywhere now.
But I was shocked to learn that Confluence can't to Markdown!
Suddenly, Confluence feels stone-age and very limited. Thinking of other possible shared documentation repository solutions...
Hi, for everyone that has come to this topic looking for answers or wanting enhancements, it's been my experience that Atlassian doesn't prioritize work on feature requests unless there is an issue filed that generates community interest.
But since their bug/issue tracking system is buried in their website, it may be hard to find. For Confluence Server in general, you can go here:
There is a separate project for Confluence Server, if that is what you are using but I think features tend to make it into the Cloud version first.
I found an open Suggestion ticket here:
Given that I have come across numerous Atlassian Community posts lamenting about this for several years, I think that there is significant demand that hasn't been given proper visibility to Atlassian.
If you want this feature, please go vote for it.
Thanks everyone for answering last week’s question. The winner of the random drawing from those who commented is: @LarryBrock I’ll contact you separately with your prize details. This wee...
Connect with like-minded Atlassian users at free events near you!Find an event
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no Community Events near you at the moment.Host an event
You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events