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, content is read 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 Browser Label | Parameter | Default | Description |
|---|---|---|---|
| Profile | profile | Default parameters provided by the administrator. To know more about profiles, refer to this link. | |
| URL to markdown file | url | Refers to the URL of the Markdown file. | |
| URL user | user | User name for URL access that requires basic authentication. | |
| URL password | password | User password for URL access that requires basic authentication. | |
| URL connection timeout | timeout | Used to increase the wait time for URL access on slow connections. | |
| File encoding | encoding | UTF-8 | Encoding for an external file, if different from default system handling. |
Common parameters
The following parameters are available for all the Markdown macros:
Enter a comma-separated list of regex patterns to post-process the output for Markdown content with find and replace logic. Example: (href=)(/display) Enter a comma-separated list corresponding to find patterns via index position in the list. These are single quote entries containing a comma. Example: $1$base_url$2 Select this option to display content on separate lines. This is a GitHub Flavored Markdown extension and is selected by default. Specify the table class (CSS) to apply to render tables. Currently, Confluence Cloud does not support the use of custom user-defined styles.Macro Editor Label Default Description Macro Parameter Find regex patterns find replace Allow HTML tags false Select this option to allow HTML tags in the macro body. The option is deselected by default. allowHtml Hard wrap newlines true Text Hard wrap (selected) Soft wrap (Hard wrap not selected) Roses are red
Violets are blue
Roses are red
Violets are blue
Roses are red Violets are blue
hardwrap Table class @default tableClass
Screenshot
The following example uses an absolute URL in URL to markdown file of the macro settings:
