Parameters
Parameter | Default | Macro Browser Label | Description |
---|---|---|---|
profile | Profile | Administrator provided parameter defaults. Some profiles may be restricted. Since 2.0. | |
url | URL to Markdown file | Example: url=https://bobswift.atlassian.net/wiki/download/attachments/41976045/basics.text?api=v2 | |
user | URL user | 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 | Use to increase wait time for URL access on slow connections | |
encoding | system default | File encoding | Encoding for an external file if different from the system default hanlding |
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 | |||||||
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.
| 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.
| 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