Versions Compared

Key

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


Warning
titleDeprecation notice (applicable for Markdown from a URL macro):

Please note that the URL user and URL password parameters are deprecated and will be removed on March 31, 2022. We recommend using profiles to access your data from remote locations.

This article discusses the recommended way of how URLs must be used in correlation with profiles in the Markdown from a URL macro. This page also contains more information about the URLs that can be given, the order used to process URLs, and finally, how URLs must be used with profiles in the macros.

...

Info

Contact your Confluence administrator to know which profiles are available in your instance.

Click any of the links to know more:

Anchor
md_URLTypes
md_URLTypes
URLs in macros

...

Priority givenURL typeDescription
1Application links

If the given URL is linked to a specific application like Bitbucket, GitLab, or GitLab, the macro does not require any user credentials, and processes and renders the given file. Refer to this article for information about application links.

2ProfilesIf Profile is specified, the macro appends the URL given here with the URL specified in the profile configuration, and accesses the location to render the required file.
3Simple URLsLastly, if no application links or profiles were given, the URLs are processed as-is and the required file is rendered.

...

Note
  • Here, the profile is to be linked with GitLab and the base URL of the application is taken automatically in the URL field. This URL is editable and can be changed according to your requirement.
  • In the given screenshot, an Access token is provided whereas the User and Password parameters are left empty. This is because the access token works almost like a direct link to the specified URL and thus, does not require user credentials. See the profile configuration documentation for more information about access tokens.
  • See the Additional links section for more information about profile creation. 

...

Anchor
md_tutorials_URLProfiles_AddlLinks
md_tutorials_URLProfiles_AddlLinks
Additional links