- Markdown Clips
- Basic, extended and GitHub Flavoured Markdown syntax Clips for Nova.
- 4431 Installs
Readme
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
- Download the extension from the project's GitHub repository.
- 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.
Changelog
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 ๐