Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 administerConfluence administrator. 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:

...

Macro Editor LabelDefaultDescriptionMacro 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 encodingUTF-8

Specify the encoding for an external file, if different from default system handling.

encoding


Info
titleHow profiles and URLs are processed in the macro

Depending on the values provided for the Profile and URL to markdown file parameters, the following process applies:

Is Profile given?

(Y - Yes, N - No)

Is URL to markdown file given?

(Y - Yes, N - No)

Macro behavior
YNAccesses the URL specified in the profile through the pre-configured information.
NYAccesses the URL specified and renders the Markdown content as required.
YYAppends the URL mentioned in the URL to markdown file parameter to the URL configured in the profile. Thus, the macro creates a relative path to the Markdown file. If this path is not valid, a network error message is displayed. To resolve this issue, contact your Confluence administrator for more information.


Common parameters

The following parameters are available for all the Markdown macros:

...