I want to Publish Markdown to Confluence, Is there a tool to publish it directly ?
Asked by Adharsh Manikandan:

I have some markdown pages (like Readme.md in bitbucket) which I would like to publish to confluence. Is there any tool that would use the Confluence API to publish the markdown as a Wiki page in confluence?


Answers:
author: Kishan Sharma
body: Hi [@Adharsh Manikandan](/t5/user/viewprofilepage/user-id/4602859) Welcome to the Atlassian Community! Could you please let us know what is the format of the markdown pages ? is it a text or code in any programming language ?

comments: author: Adharsh Manikandan
body: Hello [@Kishan Sharma](/t5/user/viewprofilepage/user-id/554991) ,

I am thinking of documentation as code with files similar to Readme.md in bitbucket. And publish them to Confluence automatically upon changes ( would be great if create, update are available )


author: Kishan Sharma
body: Thanks for confirming. I haven't come across any plugins that can trigger automatic confluence page creation process (from other tools except JIRA), but you can write your own script and using REST API endpoints you can create / update pages in your confluence wiki. Refer REST API documentation [here.](https://developer.atlassian.com/cloud/confluence/rest/api-group-content/#api-wiki-rest-api-content-get) I think the challenge here will be the trigger point to know when to create/update page. On unix - you can create a cronjob to keep monitoring your readme.md file in bitbucket and then hit rest call to update the confluence page if there are any updates to it.


author: mmcgowan
body: ==\>the trigger point to know when to create/update page.

Given the context of the question, I suspect that would be whatever triggers a build in the bitbucket repo.

I am also interested this question and did a quick search of the marketplace and there are a couple that looked interesting that have both server (our current implementation) and Cloud (where we are all headed). Both of these mention import from bitbucket, etc. I have not tried either.

* [https://marketplace.atlassian.com/apps/1211445/markdown-for-confluence?hosting=cloud\&tab=overview](https://marketplace.atlassian.com/apps/1211445/markdown-for-confluence?hosting=cloud&tab=overview)
* [https://marketplace.atlassian.com/apps/1215703/markdown-extensions-for-confluence?hosting=cloud\&tab=overview](https://marketplace.atlassian.com/apps/1215703/markdown-extensions-for-confluence?hosting=cloud&tab=overview)


author: Giorgio Catenacci
body: [@Adharsh Manikandan](/t5/user/viewprofilepage/user-id/4602859)any updates on this?  
Did you find a solution or use any of the marketplace apps suggested up here?  

I am very curious about it and I would like to know if you find a solution!  

I would like to enable something similar :-)


author: Adharsh Manikandan
body: [@Giorgio Catenacci](/t5/user/viewprofilepage/user-id/4598693)

I found two tools mark written in go and md to confluence written in python.

Anyhow I ended up writing my own tool to do that using.. atlassian api sdk written in python.


author: Ross Murphy
body: [@Giorgio Catenacci](/t5/user/viewprofilepage/user-id/4598693)I don't think [@Adharsh Manikandan](/t5/user/viewprofilepage/user-id/4602859) took your meaning that you wanted him to share the links or names.  

I would also love to see a simple python example. Care to share?


author: Vinu S Renish
body: [@Adharsh Manikandan](/t5/user/viewprofilepage/user-id/4602859) can you share the links of the tools that you found?


author: Adharsh Manikandan
body: [@Vinu S Renish](/t5/user/viewprofilepage/user-id/5080075) I ended up writing my own tool that uses confluence api

to satisfy the whole needs some tools helped in the process,

<https://github.com/atlassian-api/atlassian-python-api>

<https://github.com/duo-labs/markdown-to-confluence>

<https://github.com/justmiles/go-markdown2confluence>


author: Vinu S Renish
body: Thanks [@Adharsh Manikandan](/t5/user/viewprofilepage/user-id/4602859)


author: Andrew McClenaghan
body: Hi,  

I have launched a set of tools to help with publishing Markdown to Confluence. I would appreciate some feedback if they are helpful and if there is any improvements that you are using in other tools and like having.   

<https://github.com/markdown-confluence>

<https://markdown-confluence.com/>

<https://markdown-confluence.atlassian.net/wiki/spaces/docs/overview>

Cheers,

Andrew


author: bartolomeo sorrentino
body: hi, take a look also to <https://www.npmjs.com/package/confluence-site>


Tags: atl-gruland

cloud

confluence-cloud