Auto-import markdown documents as pages from git repositories

Question

I just witnessed the repeated disagreement in my team between putting documentation close to the code in github and putting it on confluence where it's all centralised.

Wouldn't it be great if confluence allowed adding:

* a link to a markdown file in a git repository which is then converted into a page and kept up to date
* a link to a folder of markdown pages in a git repository, which is then converted into a tree in a space's pages section and kept up to date with changes in the repository
* and made it easy to search across all of these documents along with the confluence pages our functional and management people love so much?

CANIHAZ? :)

Roman Stoffel · Answer

We (Mibex Software) have the Include Bitbucket/GitLab/Github for Confluence apps, which may help this use case.

You can include files from the repository and render them in a Confluence page.
Markdown and AsciiDoc documents are rendered into the page by default.

There are limits:
  - Include GitLab/Github only have Cloud verision at the moment.
  - Cloud versions cannot include multiple files. You have to include it file by file.
  - Include Bitbucket for Confluence DC/Server can include multiple files via an search expression, but doesn't show those as a nice tree.

Anyway, you can try the apps out. If its close to your use case, but are missing something, let us know.

Patrick Zivkovic · Answer

@Claudio Bantaloukas do you have a solution to this topic? We are facing similar problems.

Claudio Bantaloukas · Answer

I guess I'm lucky enough to work for a company with few such barriers :)

Administrators on such companies will probably need a we-cant-have-the-good-things switch!