External File Linker

approved

by Kay606

Embed external files into your notes.

26 stars3,424 downloadsUpdated 3mo agoMIT
View on GitHub

GitHub Release Obsidian Downloads

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

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.