What Capable GitHub is

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

GitHub for Confluence lets you put a file from a GitHub repository straight onto a Confluence page, where it renders live: code with syntax highlighting, Markdown as formatted text, diagrams as pictures, and images inline. It comes with one macro, "Github file (Capable)", which you add either from Confluence's macro browser or simply by pasting a GitHub file link into the editor. Each person connects their own GitHub account, so people only ever see repositories they personally have access to. Public files need no connection at all and are visible to everyone, including logged-out readers. The capability also adds a page byline showing which GitHub files a page contains, a "Github" section in the Capable app for browsing every page that references GitHub files, and search columns and filters so you can find those pages. In Confluence it is GitHub-only; there is no GitLab or Bitbucket support, and no site-wide or admin-level GitHub connection.

A Markdown file from a repository renders as formatted text with its images in place, rather than as raw source.
A Confluence page called Git files, with a byline showing a count of two files, a heading, a GitHub file path for a Capable repository, and a TypeScript configuration file rendered with line numbers a
The file is fetched from the repository each time the page loads, so the code below the heading is whatever is on the branch now.

#At a glance

A Confluence page called Git files with a heading reading mermaid from a public repo, a GitHub file path beneath it, and a C4 container diagram drawn from that file showing a person, a web application
A mermaid file in a repository arrives on the page as a drawn diagram rather than as its source text.

#A few things worth knowing

  • Three of the four settings a user could plausibly reach do nothing useful: Show Line Numbers is completely inert (and line numbers are permanently on), Title is stored but never displayed, Description is never even collected, and Show Borde

  • The four-field form is effectively unreachable in normal authoring anyway, because editing the macro opens the Browse GitHub picker instead, and the macro is hidden from Capable's own catalogue, command palette and insert-macro action.

  • Re-picking a file silently resets Show Border and Show Line Numbers to true and drops Description, because the save routine rebuilds the whole configuration from scratch.

The short version.