# Github file

---

## Settings

| **Setting**                   | **What it changes**                                                                                                                                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Owner/repo                    | The repository the file is read from. Together with File path it decides whether the macro renders at all: with either one missing, the macro shows a "Select File" invitation instead of content.                                               |
| Path inside the repository    | The file to display. Also drives the derived file type and language, the base URL used to resolve relative images in Markdown, and the raw URL the content is fetched from.                                                                      |
| Any branch, tag or commit ref | The ref the file is read at. Shown in the macro header in parentheses only when it is not 'main'.                                                                                                                                                |
| Show Border                   | Draws a border ONLY around the macro's non-content states: the unconfigured "Select File" invitation, and the anonymous, not-connected and error cards. A successfully loaded file is never bordered, so turning it off changes nothing on a wor |

---

## Related

[MacrosEvery macro in this capability.](https://help.gocapable.com/git/macros.html)

---

_One macro, documented properly._