The ExternalContent extension allows for embedding external content, such as markdown files, in your wiki pages. The standard configuration allows embedding links from GitHub and Bitbucket.
Embedding external content
Copy and paste
In visual editing mode, you can simply copy the url to your clipboard and paste it into the wiki page in visual editing mode. The visual editor will automatically convert the url to an embedded view of the actual external content.
| Parameter | Description |
|---|---|
| URL | External location of the embedded file. |
| Language of embedded content | One of the supported languages [1]. Only required if the language is not detected by the file extension. |
| Lines to show | Show only specific lines. This can be a single line number or a range separated by a hyphen (-). Multiple line numbers or ranges can be separated by commas. |
| Show line numbers | Displays the line numbers of the embedded block. |
Content Droplet
To embed a GitHub or Bitbucket link, you can also select the related Content Droplet:
- External content (for GitHub)
- Bitbucket file
Suppressing the conversion of an external link
If you want to create a link to the external page instead of embedding it, you must copy the URL into the page as plain text (e.g., using the keyboard shortcut Ctrl+Shift+V).
Configuring allowed external content
In the configuration manager, you can restrict the domains and file types that can be embedded in the wiki:
Included starting with v5.2+.
- Domain whitelist: List of domains whose content can be embedded in the wiki. If no domains are defined, there are no domain restrictions.
raw.githubusercontent.com.
- Field extension whitelist: List of file extensions that can be embedded from external content in the wiki.
