Extension Details

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 or Insert Image Link

You might also choose to set a keyboard shortcut using Nova → Settings... → Key Bindings, such as:

• Cmd+Shift+L to invoke Insert File Link
• Cmd+Shift+I to invoke Insert 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
• Images Folder Name
  • default: images
• Path Transformation Regex
  • default: ^\/?(?:.*?\/)?(?:\d{4}\/)?(?:(\d{4})-(\d{2})-(\d{2})-(.+))$
  • eg. _posts/2025/2025-04-15-when-playdate-stopped-being-fun.md
• Path Replacement Pattern
  • default: /$1/$2/$3/$4/
  • this reformats the date into subfolder style
• File Extension to Remove (comma separated)
  • default: .md,.markdown
  • these extensions are trimmed when inserting a link to a post
• Sort Order for File List
  • default: date
  • this sorts by blog post slug date, most recent first

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.

Version 2.0.0

Add: results in the choice palette are now sorted by default using dates found in filenames, shows all files more consistently, and .DS_Store files are skipped

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