Type wiki markup directly into the editor. Confluence will convert it to the rich text editor format as you type. Create links using the Advanced tab of the Links Browser. Add custom content to the sidebar, header or footer of a space. Insert a block of wiki markup (or markdown) into the Confluence editor. (Choose Insert Markup.). Mar 10, 2021 Webhooks provide a way to configure Bitbucket Data Center and Server to make requests to your server or another external service, whenever certain events occur.
I recently did some investigations at work on how to keep documentation up to date. I guess we’ve all been in the situation that the documentation we have is drifting from how the actual systems/applications look like. I believe that it’s easier to keep the documentation close the the actual code, e.g by README’s in markdown, than by have them as separate confluence pages that no one remembers to keep up to date. If you are using Confluence you can create/update documentation by using the REST api, however Confluence does not accept markdown so you have two options;
- install markdown plugins (that’s available in the api)
- or convert markdown to confluence markup language
Confluence Markdown
I went with the latter options since that felt a bit easier. I found this ruby gem. Unfortunately it’s installed as a gem with dependencies you might not have available and it only runs as a cli-tool which might not be ideal if you want to include this as a step in your CI/CD pipeline. I quickly hacked together a way to run this gem as a REST server instead inside a docker container, which eliminates bothersome dependencies and make’s it easier to include in your pipeline.
Confluence Markdown Import
Quick Tutorial
![Confluence Markdown Confluence Markdown](/uploads/1/1/7/7/117793332/359223286.jpg)
- Run the container by pulling the image from docker hub:
Confluence Wiki Markup
- Test the conversion (example script in ruby)
Asciicast Demo
Complete Example
Confluence Paste Markdown
If you want to check out the complete source code you can take a look at this repo and follow the README.