https://github.com/marcjulianschwarz/obsidian-file-link

A plugin for the note taking app Obsidian to add better external file links to your notes.
https://github.com/marcjulianschwarz/obsidian-file-link

markdown markdown-editor obsidian obsidian-md obsidian-plugin obsidianmd

Last synced: 17 days ago
JSON representation

A plugin for the note taking app Obsidian to add better external file links to your notes.

• Host: GitHub
• URL: https://github.com/marcjulianschwarz/obsidian-file-link
• Owner: marcjulianschwarz
• License: mit
• Created: 2021-08-24T17:07:10.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2025-01-31T13:07:07.000Z (3 months ago)
• Last Synced: 2025-01-31T14:21:59.681Z (3 months ago)
• Topics: markdown, markdown-editor, obsidian, obsidian-md, obsidian-plugin, obsidianmd
• Language: TypeScript
• Homepage: https://www.marc-julian.de
• Size: 12.1 MB
• Stars: 122
• Watchers: 2
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• project-awesome - marcjulianschwarz/obsidian-file-link - A plugin for the note taking app Obsidian to add better external file links to your notes. (TypeScript)
• jimsghstars - marcjulianschwarz/obsidian-file-link - A plugin for the note taking app Obsidian to add better external file links to your notes. (TypeScript)

README

        
# Better File Link for Obsidian

![Better File Link Banner](https://user-images.githubusercontent.com/67844154/158657066-47b6b0fb-439c-4973-82c7-9768ee472344.png)

An Obsidian plugin that streamlines adding external file links to your notes. Say goodbye to manual drag-and-drop - select files directly within Obsidian's interface.

## ✨ Key Features

- **Seamless File Selection**: Choose files without leaving Obsidian

- **Customizable Link Prefixes**: Add custom prefixes for multiple file links

- **Flexible Display Options**: Toggle file extensions visibility

- **Smart Link Behavior**: Choose between opening files or their containing folders

- **File Embedding**: Embed files directly in your notes

## 🎯 Supported File Types

### For Embedding

- **Documents**: MD

- **Images**: PNG, JPG, JPEG, GIF, BMP, SVG

- **Audio**: MP3, WebM, WAV, M4A, OGG, 3GP, FLAC

- **Video**: MP4, WebM, OGV

- **Documents**: PDF

## 🚀 Quick Start

1. Press `Cmd/Ctrl + P` to open the command palette

2. Search for "Add file link"

3. Click "Select files"

4. Choose your desired files

5. Toggle embedding option if needed

6. Click "Add file link"

## 🎮 Demo

[Watch Demo Video](https://user-images.githubusercontent.com/67844154/131221777-2ad1c138-90a5-4429-b481-380f8618d6ad.mp4)

## ⚙️ Configuration

### Customization Options

- **List Style**: Configure prefix characters for multiple file links

- **File Extensions**: Toggle visibility of file extensions

- **Link Behavior**: Choose between opening files or their containing folders

![Settings Screenshot](https://user-images.githubusercontent.com/67844154/131246371-68049aa6-34a5-421c-b478-513427525700.png)

## 📝 Changelog

### 1.1.3

- Added short links option to settings [#10]

### 1.1.2

- Security enhancement: Updated moment.js

### 1.1.1

- Fixed Windows path compatibility issues [#1]

### 1.1.0

- Introduced file embedding feature

- Added select options in pop-up [#3]

*[View full changelog on GitHub]*

## 🤝 Contributing

- **Bug Reports & Feature Requests**: Visit our [GitHub Issues](https://github.com/marcjulianschwarz/obsidian-file-link/issues)

- **Icon Design**: Special thanks to [Olli Graphics](https://www.olli-graphics.de)

## 📫 Support

Having issues or suggestions? Feel free to:

- Open an issue on GitHub

- Join the discussion in the Obsidian community

---

*Made with ❤️ for the Obsidian community*