Parameters

Parameter	Default	Macro Browser Label	Description
profile		Profile	Default parameters provided by the Administrator. Some profiles may be restricted. Since 2.0.
url		URL to Markdown file	Refers to the URL of the markdown file. For markdown files available on apps linked to Confluence, entering the username and password parameters may not be necessary. To know more about linking applications with confluence refer to Application Link. Since 3.4
user		URL user	The user name for URL access that requires basic authentication.
password		URL password	User password for URL access that requires basic authentication.
timeout		URL connection timeout	Used to increase the wait time for URL access on slow connections.
encoding	UTF-8	File encoding	Encoding for an external file if different from the system default handling.

Common parameters

Macro browser label Default Description Macro parameter

Id generated value Enter the HTML ID of the div element surrounding the content. id

Find regex patterns

Enter a comma-separated list of regex patterns to dynamically update the output for Markdown content with find and replace logic.

Example: (href=)(/display)

find

Replacement strings

Enter a comma-separated list of positions to search for patterns in the output content. Note that the positions are indexed beginning at "1". If a comma is a part of the search, use single quotes (') around it.

Example: http://www.google.com/$1

replace

Allow HTML tags false Enable this option to allow embedded HTML tags in Markdown macros. This is a potential security exposure, so it is disabled by default. The Confluence administrator must explicitly authorize users or groups using Macro Security for Confluence. allowHtml

Hard wrap newlines

true

Determines how newlines are treated. This is a GitHub Flavored Markdown extension that defaults to being turned on.

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

Anchor links for headings false Enable this option to automatically add anchor links for headings. headerLinks

Table class

@default

Enter the CSS to be applied to rendered tables.

@default - Apply default Confluence table class to rendered tables.
@none - Do not apply any style for rendered tables.
userDefinedClass - Use a custom user-defined style for rendering Tables.

tableClass

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}

Screenshot

Example using a public Bitbucket file: https://bitbucket.org/bob_swift/gint/raw/tip/README.md

Markdown-url macro

Parameters

Common parameters

Basic Use

Screenshot