Extension Details

Markdown Clips for Nova

Markdown Clips is a collection of basic, extended, and GitHub Flavoured Markdown syntax snippets, for use with Panic Inc's Nova IDE.

Proudly made, with love, in the UK.

Installation

Nova's Extension Library

You can install this extension through the Extension Library. Search for Markdown Clips and press Install.

Manual method

1. Download the extension from the project's GitHub repository.
2. Double click the .novaextension file you download and opt for installation when Nova prompts you.

Usage Guide

Don't forget to set your document syntax to Markdown, so the extension can work its magic. (You can set the default syntax in Nova's Editor settings if you want new files to begin in the Markdown format).

Automatic suggestions, or drag and drop. Your choice.

Markdown Clips will make suggestions as you type words and phrases into the Nova editor. You can use the arrow keys on your keyboard to move up and down the autosuggest list, and press Enter to insert your selection.

You can also open the Clips sidebar to visually browse the library. Nova will let you double click, or click and drag into the editor.

Trigger clips with Syntax

You can also invoke clip suggestions using related syntax. For example, typing a right facing chevron > will autosuggest all block-quote clips and typing a left facing square bracket [ will autosuggest all link clips.

Clip Group	Keystroke Trigger
Block-quotes	>
Code	§
Comments	<
Formatting Tools	_ (Underscore)
GitHub Alerts	±
Headers	#
Images	!
Links	[
Lists	=
Tables	| (Pipe)

Some keystrokes are protected by Nova and don't trigger autocomplete. For these I've assigned different single character triggers.

Use common formatting keystroke shortcuts

Text can be made bold, italic, and underlined using the familiar Cmd+B, Cmd+I, and Cmd+U commands. Markdown Clips will apply these formatting styles to selected text too.

Support the Project

If you find Markdown Clips useful and would like to support the project, you can always buy me a coffee.

You can find other projects of mine on my website.

Version 1.6

🎁 What's New?

GitHub Alerts (GitHub Flavoured Markdown)

Markdown Clips now contains clips for the five GitHub Alert styles; Caution, Important, Note, Tip, and Warning. As always they can be selected from the Clips sidebar, they'll be suggested automatically as you type, and can be triggered using the new ± keystroke.

Collapsable sections (Open and Closed)

Clips for collapsable sections, both open and closed, are now supported. They each contain a line break after the 'summary' for better Markdown formatting support within the section itself.

Superscript and Subscript

Two new clips have been added for superscript and subscript.

Underlined formatting

For those of you who like to underline text, Markdown Clips now supports the familiar Cmd+U keyboard command. The formatting will apply to any selected text too.

Version 1.5

🎁 What's New?

Trigger on Syntax and Trigger on Shortcut

Markdown Clips will now autosuggest clips using related syntax. For example, typing a right facing chevron > will autosuggest block-quote clips and typing a left facing square bracket [ will autosuggest link clips.

Clip Group	Keystroke Trigger
Block-quotes	>
Code	§
Comments	<
Formatting Tools	_ (Underscore)
GitHub Alerts	±
Headers	#
Images	!
Links	[
Lists	=
Tables	| (Pipe)

Some keystrokes are protected by Nova and don't trigger autocomplete. For these I've assigned different single character triggers.

New Clips - Comments

Two additional clips have been added, for in-line and multi-line comments.

Improved autosuggest accuracy

Some of the clips have been renamed to improve autosuggest accuracy.

👾 Bug Fixes

Header ID clip now has a trigger (which was missing before)

Version 1.4

🎁 What's New?

New Clips

• Additional Clips for embedding Local and internet video. (Thanks to the GitLab Markdown Guide documentation for this one).
• An additional Clip for adding collapsible sections to your documents
• An additional Clip for inserting images with URLs

An icon refresh

The extension icon has been updated to fit in a little better with the macOS design language

Version 1.3

🎁 What's New?

An icon refresh

The extension app logo has been updated, to be more colourful.

🛠️ Changes

Keystroke trigger alterations

A handful of triggers have been changed, to make clip activation more natural with your writing.

• The keystroke > invokes the list of block quote options
• The keystroke - invokes text formatting options
• The keystroke | invokes the list of table options

You can still bring these up using their descriptive names though. (For example, if you start typing the word block quote, the block quote options will appear.)

Version 1.2

🎁 What's New?

Header ID's

Added Header ID's. These are useful if you want to generate links directly to headings in resulting HTML markup.

🛠️ Changes

Commands support has been removed

Commands support for bold and italic removed, as I've integrated the formatting with the clips. Same power, but easier to wield! (Repo Issue 1: Format selection with keyboard shortcuts).

Version 1.1

🎁 What's New?

Bold and Italic are now Commands

Bold and italic are now published as Commands, so you can select existing text and change its formatting.

You can use the menu, Editor > Markdown Clips, to do this or alternatively bind the commands to custom keyboard mappings within Preferences > Key Bindings > Extensions).

👾 Bug Fixes

Typing the word boot and pressing 'Enter' would replace with a blockquote.

Version 1.0

Initial release 🎉