The Markdown from a URL macro renders Markdown content from URLs or from profiles. Profiles are a means of retrieving information from other sources such as databases. To know more about the profiles created in your Confluence instance, contact your system administer. You can read more about profiles from this link. If you enter an absolute URL and also specify a profile, the macro reads content from the URL and the profile is ignored.
Basic Use
This macro can be deployed using one of the following methods:
| Selected from the Macro Browser | Markdown from a URL |
|---|---|
| Markup Shortcut | {markdown-url} |
Parameters
Macro specific parameters
| Macro Editor Label | Default | Description | Macro Parameter |
|---|---|---|---|
| Profile | Enter a profile name. Profiles are default parameters provided by the administrator. To know more about profiles, refer to this link. | profile | |
| URL to markdown file | Enter the URL of the Markdown file. If an absolute URL is given, the macro reads content from the URL and the profile is ignored. | url | |
| URL user | Enter the user name for URL access that requires basic authentication. | user | |
| URL password | Enter the user password for URL access that requires basic authentication. | password | |
| URL connection timeout | Enter time in milliseconds such that URL connections do not timeout before getting data. Use this to increase the access time needed for slow connections. Note that if a zero is given the connection may wait infinitely. | timeout | |
| File encoding | UTF-8 | Specify the encoding for an external file, if different from default system handling. | encoding |
Common parameters
The following parameters are available for all the Markdown macros:
Include Page Common parameters - Cloud Common parameters - Cloud
Screenshot
The following example uses an absolute URL in URL to markdown file of the macro settings: