site/docs/plugins/CrawlLinks.md
2024-04-05 02:03:11 +02:00

1.7 KiB

title tags
CrawlLinks
plugin/transformer

This plugin parses links and processes them to point to the right places. It is also needed for embedded links (like images). See Obsidian compatibility for more information.

Note

For information on how to add, remove or configure plugins, see the configuration#Plugins page.

This plugin accepts the following configuration options:

  • markdownLinkResolution: Sets the strategy for resolving Markdown paths, can be "absolute" (default), "relative" or "shortest". You should use the same setting here as in Obsidian compatibility.
    • absolute: Path relative to the root of the content folder.
    • relative: Path relative to the file you are linking from.
    • shortest: Name of the file. If this isn't enough to identify the file, use the full absolute path.
  • prettyLinks: If true (default), simplifies links by removing folder paths, making them more user friendly (e.g. folder/deeply/nested/note becomes note).
  • openLinksInNewTab: If true, configures external links to open in a new tab. Defaults to false.
  • lazyLoad: If true, adds lazy loading to resource elements (img, video, etc.) to improve page load performance. Defaults to false.
  • externalLinkIcon: Adds an icon next to external links when true (default) to visually distinguishing them from internal links.

Warning

Removing this plugin is not recommended and will likely break the page.

API