{"id":4117,"library":"mkdocs-link-marker","title":"MkDocs Link Marker","description":"mkdocs-link-marker is an MkDocs plugin designed to automatically mark external or mailto links within your documentation, enhancing user experience by visually distinguishing these links. It is currently at version 0.3.0 and maintains an active development cycle with regular updates addressing features and fixes.","status":"active","version":"0.3.0","language":"en","source_language":"en","source_url":"https://github.com/timmeinerzhagen/mkdocs-link-marker","tags":["mkdocs","plugin","documentation","links","external-links","mailto"],"install":[{"cmd":"pip install mkdocs-link-marker","lang":"bash","label":"Install with pip"}],"dependencies":[{"reason":"This is an MkDocs plugin and requires MkDocs to function.","package":"mkdocs","optional":false}],"imports":[{"note":"MkDocs plugins are configured directly in mkdocs.yml, not imported as Python symbols.","symbol":"link-marker (plugin entry)","correct":"plugins:\n  - link-marker"}],"quickstart":{"code":"site_name: My Docs\n\nplugins:\n  - search\n  - link-marker: # Enable the link-marker plugin\n      # Optional configuration:\n      # external_icon: ' 🔗'\n      # mail_icon: ' ✉️'\n      # ignore_urls: ['www.example.com']\n      # extra_external_attrs: {'target': '_blank', 'rel': 'noopener'}","lang":"yaml","description":"To enable the mkdocs-link-marker plugin, add `link-marker` to the `plugins` section of your `mkdocs.yml` file. You can also configure various options such as custom icons for external and mail links, a list of URLs to ignore, and extra HTML attributes for external links."},"warnings":[{"fix":"This change is intentional for better user experience, as marking image links can sometimes clutter the output. No direct configuration option exists to re-enable marking these specific links.","message":"Starting from v0.2.0, external links that are part of an image (`![alt text](https://external.link)`) are no longer marked by default. If you relied on this behavior, you might notice a change in your documentation output.","severity":"gotcha","affected_versions":">=0.2.0"},{"fix":"Review the plugin's configuration options in your `mkdocs.yml`. Explicitly define `ignore_urls` for links you don't want marked and `extra_external_attrs` to add custom attributes to external links, for example:\nplugins:\n  - link-marker:\n      ignore_urls: ['docs.example.com', 'internal.network']\n      extra_external_attrs: {'target': '_blank', 'rel': 'noopener'}","message":"Version 0.3.0 introduced new configuration options like `ignore_urls` and `extra_external_attrs`. Failing to configure these might lead to undesired link marking or lack of specific attributes, particularly if you need to exclude certain domains from being marked or add custom HTML attributes like `target=\"_blank\"` and `rel=\"noopener\"` for external links.","severity":"gotcha","affected_versions":">=0.3.0"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}