Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

External File Linker

kay607kay6073k downloads

Embed external files into your notes.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates23

External File Linker

Allows you to link to external files in obsidian to embed them

This plugin uses the usual syntax of ![[filepath]] to link to files.

eg. ![[external:filepath]]

By default, the working directory will be the vault folder the path is relative. This allows you to use ../ to access the folder directly outside of the vault with ![[external:../filename]]

Absolute file paths can also be used such as ![[external:C:/file.md]]

This plugin can link to any file type which obsidian can handle including md, pdf, png, jpg, mp3, and mp4

image

image

image

Groups

A group is a single folder which contains files and subfolders

This is used if you have a single folder with the same files on multiple devices such as Windows and Android or having a Dropbox folder in multiple locations on different devices

The groups system will check which device you are using and choose the correct base path for this

This allows you to link to external files without worrying about which device you are on as the links will always work

image

The group name, Test in the example above, will be used in all links which use the group (these will not be updated if you change the group name)

Each device has a name, uuid and base path.

The name is not required and is only there to help the user

The uuid is used to check which device is active and find the correct path for it (this will be automatically filled in when a new device is added)

The base path is where all links will be relative (eg. if the base path is D:/Test and the group name is Example, Example/file.md will link to D:/Test/file.md)

The syntax for group links is ![[group:GROUP_NAME/PATH]] eg. ![group:Group1/Directory/AnotherDirectory/file.md

The group name must come directly after group: with a / after it

image

Operating Systems

  • Windows

  • Linux

  • MacOS

  • Android

  • iOS

Installation

Install from the Obsidian Comunity Plugins tab or External File Linker

You can manually install by adding Kay607/obsidian-pathlinker to BRAT

Contribution

Feel free to create an issue or pull request

Building

Requires npm to be installed

  • git clone https://github.com/Kay607/obsidian-pathlinker --recursive Clone the repository into the .obsidian/plugins folder
  • npm i Install modules
  • npm run dev Builds the plugin when a change is made
75%
HealthGood
ReviewCaution
About
Link and embed external files with ![[external:...]] using absolute or relative paths, handling common formats like md, pdf, png, jpg, mp3, and mp4. Define groups that map a group name to device-specific base paths so the same links resolve correctly across multiple devices and operating systems.
FilesLinksAttachments
Details
Current version
1.4.3
Last updated
5 months ago
Created
Last year
Updates
23 releases
Downloads
3k
Compatible with
Obsidian 1.1.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
kay607kay607
GitHubkay607
  1. Community
  2. Plugins
  3. Files
  4. External File Linker

Related plugins

Custom Attachment Location

Customize attachment location with variables($filename, $data, etc) like Typora.

Advanced URI

Control everything with URI.

Consistent Attachments and Links

Move note attachments and update links automatically.

Note Refactor

Extract note content into new notes and split notes.

Find orphaned files and broken links

Find files that are not linked anywhere and would otherwise be lost in your vault. In other words: files with no backlinks.

Janitor

Perform cleanup tasks on your vault.

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Local REST API & MCP Server

Unlock your automation needs by interacting with your notes over a secure REST API.

QuickAdd

Quickly add new notes or content to your vault.

Recent Files

Display a list of recently opened files.