How to make a new note

docs/tools/New.md

@@ -0,0 +1,38 @@
+---
+title: New
+---
+
+# New Note
+!!! note
+    Start this with `cadmus tools new`
+
+## What does it do
+
+This provides a dialog that sets the title, heading and filename of a note, offers tags to apply and offers fuzzy search for the appropriate directory to save the note in.
+
+## How Do I use it
+
+After running the command multiple tags will be displayed, filter the tags by typing and use <kbd>Tab</kbd> to selet multiple tags and <kbd>Enter</kbd> to continue. 
+
+Next a directory list will be presented, search through the directories by typing in the name of a directory.
+
+Finally a dialog to type in a name for the title, heading and filename (which will be made to be identical) will be offered, type in title:
+
+* Spaces are fine
+* No extension
+
+The file name will be slugified with `-` and the extension `.md` will be applied.
+
+## When Would This Be Used
+
+This is great when you want to quickly make a new note in the right place with the right tags.
+
+### Example
+
+![](./media/New-Note.gif)
+
+
+## How does it Work
+
+This just uses *TMSU* and *Skim* to choose the directories and tags.
+