I want to Publish Markdown to Confluence, Is there a tool to publish it directly ?

Adharsh Manikandan October 19, 2021

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?

1 answer

0 votes
Kishan Sharma
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
October 19, 2021

Hi @Adharsh Manikandan 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 ?

Adharsh Manikandan October 19, 2021

Hello @Kishan Sharma ,

 

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 )

Kishan Sharma
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
October 19, 2021

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. 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.

mmcgowan November 12, 2021

==>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.

Giorgio Catenacci December 7, 2021

@Adharsh Manikandanany 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 :-)

Adharsh Manikandan December 8, 2021

@Giorgio Catenacci 

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.

Like Ross Murphy likes this
Ross Murphy May 9, 2022

@Giorgio CatenacciI don't think @Adharsh Manikandan 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?

Vinu S Renish November 15, 2022

@Adharsh Manikandan can you share the links of the tools that you found?

Adharsh Manikandan November 15, 2022

@Vinu S Renish  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

Like # people like this
Vinu S Renish November 16, 2022
Andrew McClenaghan May 2, 2023

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

bartolomeo sorrentino October 18, 2023

Suggest an answer

Log in or Sign up to answer
TAGS
AUG Leaders

Atlassian Community Events