- Markdown File Linker
- Insert links to local files as Markdown
- 26 Installs
-
This extension is allowed to:
- Read Files
Readme
Markdown File Linker allows you to insert links to local files as Markdown, perfect for linking between articles in your blog!
Usage
To run Markdown File Linker:
- Select the Editor → Insert File Link or Insert Image Link menu items; or
- Open the command palette and type
Insert File Link
orInsert Image Link
You might also choose to set a keyboard shortcut using Nova → Settings... → Key Bindings, such as:
Cmd
+Shift
+L
to invokeInsert File Link
Cmd
+Shift
+I
to invokeInsert Image Link
Results
You choose a local file using the file selector, such as:
_posts/2023/2023-11-21-yoyozo-how-i-made-a-playdate-game-in-39kb.md
And it will be inserted as:
/2023/11/21/yoyozo-how-i-made-a-playdate-game-in-39kb/
If you've selected some text before invoking the extension, you'll get:
[YOYOZO](/2023/11/21/yoyozo-how-i-made-a-playdate-game-in-39kb/)
If the file is in a subfolder, such as:
_posts/reviews/2013-06-29-maboshi.md
You'll get:
/2013/06/29/maboshi/
For an image you might end up with:
![IMG](/images/posts/yoyozo-teaser.gif)
Configuration
To configure global preferences, open Extensions → Extension Library... then select Markdown File Linker's Settings tab.
You can customise the following:
- Posts Folder Name
- default:
_posts
- default:
- Images Folder Name
- default:
images
- default:
- Path Transformation Regex
- default:
^\/?(?:.*?\/)?(?:\d{4}\/)?(?:(\d{4})-(\d{2})-(\d{2})-(.+))$
- default:
- Path Replacement Pattern
- default:
/$1/$2/$3/$4/
- default:
- File Extension to Remove (comma separated)
- default:
.md,.markdown
- default:
Defaults match those used by Jekyll static site generator and other blogging software.
Bonus!
The extension also includes a function to wrap the selected text in a Markdown link, and if there is a URL on the clipboard it will be used as the destination of the link.
Changelog
Version 1.4.x
Add: support for linking to files inside folders in _posts
Version 1.3.4 & 1.3.5
Change: file extensions are now an editable list
Version 1.3.3
Add: remove URL scheme from link text
Version 1.3.2
Change: gradient icon
Version 1.3.1
Change: readonly file access (was readwrite)
Version 1.3.0
Fix: formatting of File links
Version 1.2.2
Improved: Wrap in Markdown Link behaviour
Version 1.2.1
Improved: README and icon
Version 1.2
Added: Wrap in Markdown Link
Version 1.1
Added: support for Image Links
Version 1.0.2 and 1.0.1
Change: README formatting
Version 1.0
Initial release