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

kay607kay6074k downloads

Embed external files into your notes.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates23

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
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
8 months ago
Created
2 years ago
Updates
23 releases
Downloads
4k
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

Advanced URI

Control everything with URI.

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.

Pixel Perfect Image

Pixel perfect 100% image resizing, copy to clipboard, show image in Finder/Explorer, and much more.

Consistent Attachments and Links

Move note attachments and update links automatically.

Note Refactor

Extract note content into new notes and split notes.

Janitor

Perform cleanup tasks on your vault.

Notebook Navigator

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

Claudian

Embeds Claude Code/Codex and other local Agents as AI collaborators in your vault.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Local REST API with MCP

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