Include GitHub for Confluence Cloud provides a File, Pull Requests & Issues Macro
To add the GitHub Cloud macros for Confluence Cloud to a page:
In the Confluence editor, choose Insert > Other Macros.
Find and select the required macro ("External Content" category).
Speeding up macro input with auto-complete: Type /GitHub or /Include to see a list of suggested macros.
To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the GitHub Cloud macro.
1. Macro "GitHub File": Include GitHub Cloud file by url
This macro allows the user to include a file from a GitHub repository in order to have an up-to-date version of it in a Confluence page.
Type /GitHub File and ENTER to specify the details of this macro like the url of the file, syntax highlighting, title and line numbers.
Screen Recording 2022-08-18 at 15.20.25.movNote: Copy the file URL from your browser and paste it into the URL field.
Alternatively, you can also paste a GitHub file URL directly into the Confluence page editor.
Screen Recording 2022-08-18 at 15.23.31.mov
You can also export your files to PDF or Word
2. Macro "GitHub Pull Requests": Include GitHub Cloud pull requests with the repo path
This macro allows the user to include pull requests from a GitHub repository. Type /GitHub Pull Requests and ENTER to specify the details of this macro like the repo path (e.g.owner/repo or https://github.com/owner/repo
).
Screen Recording 2022-09-01 at 11.09.34.movA query can be added to specify the macro. Ensure you tab out of the search query to ensure that the data refreshes.
See filtering syntax here: https://docs.github.com/en/rest/pulls/pulls#list-pull-requests .
Examples:
Note: It is useful to copy/paste the repo path from the repo url
3. Macro "GitHub Issues": Include GitHub Cloud issues with the repo path
This macro allows the user to include issues from a GitHub repository. Type /GitHub Issues and ENTER to specify the details of this macro like the repo path (e.g.owner/repo or https://github.com/owner/repo
).
Screen Recording 2022-09-01 at 11.05.47.movA query can be added to specify the macro. Ensure you tab out of the search query to ensure that the data refreshes.
See filtering syntax here: https://docs.github.com/en/rest/search#search-issues-and-pull-requests .
Examples:
Note: It is useful to copy/paste the repo path from the repo url