sponsor Vim development Vim logo Vim Book Ad

Notes : Lightweight note taker plugin

 script karma  Rating 36/14, Downloaded by 2632  Comments, bugs, improvements  Vim wiki

created by
Hari Krishna Dara
script type
If you like to keep your notes in clear text files, Vim is of course the best editor you could use to edit. This plugin simply makes it easier to create, open, move, search etc. these notes using custom commands, all without having to leave the comfort of Vim.

Each note is a separate text file that is saved under a common root configured using g:notesRoot. You can open these note files just like any other file or use the :Note command with command-line completion to make it easier.

Starting to take a new note should be as simple as typing :Note. Enter your text and save to generate a name automatically based on the first line. You can also start typing in an unnamed buffer (created using <Ctrl-W>n) and later convert it as a note using :NoteAsNew command (again named automatically based on the first line).

If you prefer, you can organize the notes into subfolders using your favorite file browser (in or outside Vim) while the :NoteNewFolder, :NoteMove and :NoteRemove commands from the plugin simplify certain operations from within Vim.

- Start a new note with less number of keystrokes and less thinking
- Automatic name generation
- Ease of opening with command-line completion
- Searching for patterns
- Ease of organizing

For full documentation, refer to doc/notes.txt or generate helptags and type :help notes.txt.
install details
Expand the zip into your vimfiles/.vimrc folder. Also download and install the latest version of genutils.vim plugin (vimscript #197).
Run :helptags on your doc directory.
Point g:notesRoot to the root of your notes folder in your vimrc:
let g:notesRoot = '~/notes'

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
notes-2.1.zip 2.1 2009-09-18 7.0 Hari Krishna Dara Fixed broken :NoteSaveAs command.
notes-2.0.zip 2.0 2009-09-16 7.0 Hari Krishna Dara - Documentation in vim help file format.
- Dependency on newer genutils (2.5).
- New setting g:notesCompleteAnchortAtStart
- Full command-line completion for all commands that accept filename or
  directory paths (:NoteNewFolder, :NoteBrowse, :NoteGrep, :NoteChangeRoot
- New command :NoteSaveAs the replaces the previous :NoteAsNew with a lot more
- New command :NoteChangeRoot to make it easier to switch between multiple
  notes roots.
- Improved :NoteGrep command that is now fully compatible with the built-in
  :vimgrep. Allows specifying one or more files or folders and even supports
  completion once the pattern is entered.
- Improved :NoteBrowse with folder completion and memory of last specified
- Better folder completion (using newer version of genutils).
- Further refactoring of code for more consistent behavior of the plugin.
- Now the plugin preserves the cursor position during a file rename.
notes-1.10.zip 1.10 2009-08-19 7.0 Hari Krishna Dara Bugfix for broken filename sync.
notes-1.9.zip 1.9 2009-08-18 7.0 Hari Krishna Dara Fixed issues reported by Gary Johnson.
- Changed line endings to work on unix like systems.
- Escape filenames so that spaes will not cause an issue on unix like systems.
- g:notesWordSeparator to use a different character other than space in the filenames.
- Some valid paths in g:notesRoot (such as "$HOME/notes" or "~/notes") are not being recognized.
notes-1.8.zip 1.8 2009-08-14 7.0 Hari Krishna Dara - Added g:notesFileExtension. You can now manage files with other extension (e.g., if you keep your notes in wiki style, you can let the extension to ".wiki").
- Support for setting a 'filetype' for opened notes. By default sets to "note", but can be changed to say "wiki" if your notes are in wiki format.
- :NoteRemove command to remove current note file.
- Misc. enhancements and fixes.
notes-1.0.zip 1.0 2009-08-08 7.2 Hari Krishna Dara Initial upload
ip used for rating:

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.