Nova

Extensions


Readme

Markdown File Linker allows you to insert links to local files as Markdown links, perfect for linking between articles in your Jekyll 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:

  • /Users/matt/Projects/blog/_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/)

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{2})-(\d{2})-(.+)$
  • Path Replacement Pattern
    • default: /$1/$2/$3/$4/
  • File Extension to Remove (comma separated)
    • default: .md,.markdown

Defaults match those used by Jekyll static site generator and other blogging software.


Changelog

Version 1.1

Add image support

Version 1.0.2 and 1.0.1

Improve README formatting

Version 1.0

Initial release