External links icon

GitHub Release Dynamic JSON Badge GitHub Downloads (all assets, all releases) GitHub Downloads (all assets, latest release) GitHub last commit

[ English | 简体中文 ]

A simple plugin that automatically adds icons to the external and internal links, designed to work seamlessly in your local environment.

![demo.png](demo.png)
Built-in links ![links](docs/images/links.png) ### URL Scheme - GoodLinks - Zotero - SnippetsLab - SiYuan Note - Eagle - Bear - Prodrafts - Things - Apple Shortcuts - Advanced-URI - Craft ### WebSite - Github - 少数派 / SSPai - 微信公众号 - Medium - 小宇宙 FM - 豆瓣 / Douban - 哔哩哔哩 / BiliBili - YouTube - Ollama - ModelScope - Hugging Face - OpenRouter - SiliconFlow - 抖音 / TikTok - Baidu - flomo - Wikipedia - Archive.org - Google Docs - Google Cloud - Other Google site - 知乎 / zhihu - 晚点 / latepost ### Obsidian - Website - official site - help doc - forum - Note Link - internal link - external vault link
## Installation ### From Obsidian Community (Recommended) Open the Community Plugins tab in the settings and search for "External Links Icon" (or click [here](https://obsidian.md/plugins?id=external-links-icon)). ### Manual Installation Use the [BRAT](https://github.com/TfTHacker/obsidian42-brat) to install this plugin. 1. Install [BRAT](https://obsidian.md/plugins?id=obsidian42-brat) Obsidian plugin 2. Use `BRAT: Plugins: Add a beta plugin for testing` command to install a new plugin 3. Enter `moziar/obsidian-external-links-icon` on the popup window 4. Enjoy ## Usage ### Add Icons To add a custom icon, click **Add Website** or **Add URL Scheme** in the setting. - Only **SVG** format is supported. - The plugin will auto compress icons to improve performance. - The default icon (light mode) is required, while the dark mode icon is optional. ![add-icon.png](docs/images/add-icon.png) ### Edit Icons - You can download the icon via the download button besides it. - `Copy to dark` is a useful button if you upload the dark mode icon to the light one. - You can remove the dark mode icon if you don't need it. ![edit-icon.png](docs/images/edit-icon.png) ### Setting - By default, both URL Scheme and WebSite icon are enabled. You could disable any of them in the plugin setting. - There are two different Obsidian icons to help users better distinguish between Obsidian web links and note links. - Obsidian Note Link icon is disabled by default. You can enable either _internal link_, _external link_, or both, or disable them entirely — it all depends on your workflow. - You can customize the icon position (before or after the link), ensuring consistency with other plugins like Iconize. ![setting](docs/images/setting.png) ## Credit Inspire by [marginnote-companion](https://github.com/aidenlx/marginnote-companion).