Versions Compared

Key

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

...

...

...

...

...

After migrating or installing Markdown for Confluence, navigate to the Global Configuration screen:

  1. Log in with the System Administrator Global Permission.
  2. Navigate to Image Added > Settings > Manage apps on the sidebar.
  3. Expand the Bob Swift Atlassian Add-ons - Markdown app from the list of apps.
  4. Click Configure to open the Markdown for Confluence page where you can manage the app configuration.

Global configuration

Use the toggle to enable or disable the Global Configuration settings.

Image Added

ParameterDescription
Restrict URL accessWith version 3.3.0, a new configuration parameter, The Restrict URL access is available. This parameter  parameter controls whether or not the URL parameter on the markdown-url macro must conform to the Confluence Whitelist, provided whitelisting is enabled. Confluence allows administrators to turn on whitelisting to restrict access to URLs configured in the Whitelist settings. 


Allow JavaScript

This option controls JavaScript usage in the Markdown apps. Enabling this option allows you to execute JavaScript within the macros. Since version 3.4.

Info
  • You can also control JavaScript usage on pages that use Markdown apps. To restrict the usage of JavaScript in the Markdown macros from the Macro Security for Confluence Configuration page:
    • Enable the markdown.allowJavaScript macro for markdown macro.
    • Enable the markdown-url.allowJavaScript macro for markdown-url macro.
    • Enable the markdown-attachment.allowJavaScript macro for markdown-attachment macro.

To enable these macros, refer to Macro Security Configuration.


Help Us Improve the Product

Enabling this option reports usage data that helps us improve the app continually. The app does not send any private user data or personally identifiable information. To learn more about what is being sent, refer to Analytics Data. Since version 3.4.

Whitelist

Manage the URLs that the app can access from this page. The app is restricted to allow the specified URLs only. 


ParameterDescription
Expression
Type


Anchor
Profiles
Profiles
Profiles

...

ParameterDescription
Profiles

Profiles are configured by the administrators and consist of a common set of parameters that allow users to choose a profile in markdown-url macro. Here are some advantages of using profiles:

  • Profiles allow user authentication required by some URLs to be hidden from page viewers and editors. Only Confluence administrators have access to this information.
  • Enables macro editors to quickly configure the macro by reusing a shared definition for URL access. 
  • Relative addressing can be used making the page content less likely to require changes when base URLs are relocated. 
    • Macro configured URL (that is not a full URL) is appended to the profile provided URL.

...