PlainNotes
Simple and pleasant authoring and note taking for SublimeText.
With PlainNotes you can:
- Organize notes and thoughts
- Maintain todo-lists
- Write documents
- and probably more
PlainNotes stores and organizes all your notes in a folder and make them accessible with a single shortcut or mouse click. It also provides you with an enhanced version of Markdown markup and some good looking color schemes for note taking. It's been designed with these ground rules in mind:
- Plain text is the holy grail
- Plain text shouldn't be that plain
- Simple and Sexy is Sublime
Note: Although PlainNotes works under SublimeText 2, some features might not be available. We're not actively testing it under SublimeText 2 but will do our best to make it compatible and usable. We appreciate bug reports and pull requests.
Organizing notes
Most of PlainNotes commands are accessible from the SublimeText main menu. You
should have a menu item called Notes
right after Help
. Although, there are
faster and easier ways of running those commnads that are mentioned below.
super+F4
)
Starting a new note (-
Command palette: Open command palette and search for
Notes: new
command (typingnn
will probably find it for you).- To save note in a subfolder of the root directory use
/
:"subfolder name"/"note name"
.
- To save note in a subfolder of the root directory use
-
Shortcut: By default pressing super+F4 will create a new note. For customizing the shortcut see Keyboard Shortcuts section.
F4
)
Opening an existing note (-
Command palette: Open command palette and search for
Notes: Listβ¦
command (typingnl
will probably find it for you), the command will show the Latest Notes quick panel from which you can select or search for your file. The Latest Notes quick panel is sorting files based on their last-edit time, so the note that you have been working on recently should be on top of the list. -
Shortcut: By default pressing F4 will open the Latest Notes quick panel. For customizing the shortcut see Keyboard Shortcuts section.
F1
)
Jotter (Jotter will let you jot down your thoughts and ideas quickly without disturbing your work-flow. It opens a Note Panel at the bottom of the editor which is ready to take your note. When you press ESC it automatically closes the panel and saves your note with a time stamp in your Inbox.
It can be accessed by pressing F1 (that can be customized in your
Key-bindings if it conflicts with your other key-bindings) or through
Notes: Jotter
in command palette.
The default color scheme of the jotter panel can be customized in user
settings (Preferences -> Package Settings -> PlainNotes -> Settings - User
):
{ "jotter_color_scheme": "Packages/PlainNotes/Color Schemes/Sticky-Yellow.tmTheme" }
Inbox
Inbox is where all your quick notes from Jotter live. You can view inbox
through Notes: Inbox
in command palette or via the Notes main menu.
The date and time format of the note headers in inbox can be customized in user
settings (Preferences -> Package Settings -> PlainNotes -> Settings - User
):
{
"jotter_date_format": "%d %b %Y",
"jotter_time_format": "%I:%M %p"
}
ctrl+F4
)
Notes Index Card (Pressing ctrl+F4 or selecting Notes: Index
from the command
palette will give you the Notes Index Card with the list of all notes sorted
alphabetically.
Pressing Enter on any note will open it in a new tab.
Change note color
Open command palette and search for Note: Change Colorβ¦
. it will give you a
list of 10 different colors that is shown in the above image. Pressing up and
down will give you a preview.
Color of the note is remembered by PlainNotes and whenever you open that file,
PlainNotes will set the color-scheme automatically.
Archive note
Open command palette and search for Note: Archive
. This will move the note
into an archive folder than can be specified in the settings -- The default
archive directory is .archive
. Archiving a note hides it from the Index and
List.
Unarchive notes
Open command palette and search for Note: Unarchive...
. This will open a
list of archived notes sorted by modification date. Selecting one from the
list will unarchive that note.
Delete note
Open a note and then open command palette and search for Note: Delete
.
Rename note
Open a note and then open command palette and search for Note: Rename
.
Change note file extension
You can change the note file extension in settings. To do so, go to
Preferences -> Package Settings -> PlainNotes -> Settings - User
and modify
"note_save_extension":
. The default note type is .note
which has the
possibility of setting different note colors and some special markup.
Alternatively you can use any note extension you want such as markdown .md
.
Add yaml front matter to notes
Go to Preferences -> Package Settings -> PlainNotes -> Settings - User
and
modify "enable_yaml"
By default, the following yaml items are added:
title:
date:
tags:
To add more yaml items you can add them to the settings by modifying note_yaml:
:
{ "note_yaml" : ["categories"] }
Other features
- Open URLs: place cursor on the link then press
enter
to open a url in the browser. - Preview images inline: place cursor on a markdown image with inline image url and press
enter
to a preview popup of that image. You should have ST 3070 or newer for this feature to work.
Per-project notes
To have a different notes directory for a project, add the following in your
.sublime-project
file:
"settings": {
"PlainNotes": {
"root": "path/to/notes/dir"
}
}
Authoring notes
PlainNotes provides an enhanced version of Markdown. It means that you can write your notes in plain markdown without learning anything new. In addition, it gives you some extra markups to improve the look and feel of your documents, since markdown sometime feels too simple to format a real document.
If you are new to markdown here is a cheat-sheet:
Markup | Markdown Syntax |
---|---|
Italic | _italic_ or *italic* |
Bold | __bold__ or **bold** |
Images | ![Image Title](http://url_to.image) |
Links | [Link Text](http://link.url) |
Inline Code | `code` |
Quotes | > Here is a quote block |
Separators | ---- or ***** |
Heading 1 | # Heading 1 |
Heading 2 | ## Heading 2 |
Heading 3 | ### Heading 3 |
Heading 4 | #### Heading 4 |
Extra Markup
Admonitions
When writing a note, you might need to distinguish a block or section by giving it a special title and box. These sections might appear several times in your document. Some examples would be Note, Tip or Caution blocks in an article.
Here is how to create an admonition block
!!! ADMONITION_TYPE "Optional title in quotes"
Any number of other indented markdown elements.
By default admonitions block have a purplish background color (that might be different based on the color scheme), but giving it a specific type from table below can change the color. Predefined admonition types are listed in table below and are shown in image above. Note that admonition types can be lower- case, upper-case or title-case.
Predefined Admonition Type | Block Color |
---|---|
hint or tip |
bluish |
warning or caution |
yellowish |
danger or error |
reddish |
attention |
greenish |
Admonition blocks can have any PlainNotes enhanced markdown inside them and they customize the look and feel so that everything looks sublime.
License
Copyright 2014-2015 Allen Bargi. Licensed under the MIT License