Skip to content

Application Settings

Vladimir Schneider edited this page Dec 15, 2018 · 6 revisions

Markdown plugin IDE wide settings across projects.

In release 2.8.0 many of settings previously found in this pane were moved to Editor Settings, if you have an earlier version and do not see a setting in this page please check Editor Settings.

Screenshot Main Unlicensed

  • Check updates for:: selection the plugin update chanel to monitor for updates
  • Installed Version: installed plugin version

Application Settings

ℹ️ Settings related to Editor have moved to their own settings panel Editor Settings

  • Version feature summary notification: enables feature summary notification on plugin update

  • Split preview for HTML documents: enables plugin's HTML preview for HTML documents. Mainly intended to preview HTML documents exported from Markdown documents but works reasonably well for all HTML documents within the preview browser limitations.

  • Global page zoom (0.1-10): sets the IDE wide preview page zoom. Use this setting to compensate for OS and Screen specific resolution. Project specific and OS/System independent zoom settings should be set in Preview Settings

  • Disable GIF images in preview: enabling this setting will disable all GIF image display in preview. Large, animated GIFs can cause the preview to use a disproportional amount of memory and cause the IDE to appear to hang as the GC spends all available time trying to free up memory. This setting will prevent display of all GIFs, eliminating this issue.

  • Simple Structure View: changes structure view to hierarchical headings without all other sections.

  • HTML Mime: sets options for Copy Markdown as HTML formatted text action

    • Max Image Width: sets the maximum image width
    • Font Family: sets the font family. Leave blank for default.
  • PDF Export: sets the options for Export rendered Markdown as PDF action.

    • Max Image Width: sets the maximum image width.
    • Font Family: sets the font family. Use the drop down to select available fonts for PDF export.
      • Font dropdown: shows available font families available in exported PDF documents.
  • Remote Links: options for validation/completion of remote URL links.

    • Validate Links: when enabled remote links will be validated by attempting to load remote content. ℹ️ If the server returns a response without an error then the URL will be treated as correct. No validation for type of data is performed.
    • Validate Anchor Refs: when enabled remote link anchor refs will be validated by loading the page and looking for a or h1 through h6 tags with name or id attribute which matches the anchor ref.
    • Complete Anchor Refs: when enabled completion of remote link anchor refs will be done by loading the page and showing all name or id attributes of a or h1 through h6 tags.
    • Minutes to cache: how many minutes to keep cached file content, 1 to 1440. Default is 60 minutes. Since you can clear the cache to force validation of all remote links you can safely keep this value at 60 or higher to avoid unnecessary fetching of remote link content.
    • Max requests: maximum simultaneous remote link HTTP requests, 1 to 10.
    • Clear Cache: clicking the button will remove all cached content, forcing all remote link content to be refreshed. Useful when you either know the server content has changed or you wish to clear cache content for URLs which are no longer part of any open markdown document to reduce cache memory use.
    • 0: 0 B: displays current cached content memory footprint in the form: links: content, with links giving the number of remote links, content given as: B - bytes, KB = 1024 bytes, MB = 1048576 bytes. Only links with anchor refs or ones for which anchor ref completion was invoked will have their actual content cached. Link validation only stores a status whether the link is valid or in error, without storing returned content.

    ℹ️ If the URL file extension matches a Markdown Language extension, then will download the markdown file and render it as HTML to extract anchor definitions.

    • Special handling for GitHub links (starting with http:// or https:// followed by github.com)
      • markdown files: If the link is to a blob type then will use raw type URL to get Markdown so it can be correctly rendered as HTML to extract anchor definitions.
      • html content:
        • remove user-content- prefix from anchor refs (GitHub adds these automatically)
        • remove [0-9a-fA-F]{32}-[0-9a-fA-F]{40} looking anchor ids
    • Special handling for GitLab links (starting with http:// or https:// followed by gitlab.com)
      • markdown files: If the link is to a blob type then will use raw type URL to get Markdown so it can be correctly rendered as HTML to extract anchor definitions.
      • html content:
        • remove [0-9a-fA-F]{32}-[0-9a-fA-F]{40} looking anchor ids

License Information

Show/Set License information for the plugin:

Unlicensed Plugin Options

Screenshot_Unlicensed.png

  • Get Trial License: navigates browser to trial license page.
  • Load License from vladsch.com: opens dialog to allow you to enter your license information so it can be fetched from the vladsch.com license server.
  • Buy License: navigates browser to buy license page.
  • Use secure connection: enables using secure protocol for license activation. Disable if encountering connection errors on corporate networks which block secure communications to external addresses.

Licensed Plugin Options

Screenshot_Licensed.png

  • Remove license: removes the current license configuration.
  • Use secure connection: enables using secure protocol for license activation. Disable if encountering connection errors on corporate networks which block secure communications to external addresses.