• Stars
    star
    274
  • Rank 145,017 (Top 3 %)
  • Language
    Python
  • Created almost 10 years ago
  • Updated almost 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Simple and pleasant note taking for SublimeText

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.

Starting a new note (super+F4)

  • Command palette: Open command palette and search for Notes: new command (typing nn will probably find it for you).

    • To save note in a subfolder of the root directory use /: "subfolder name"/"note name".
  • Shortcut: By default pressing super+F4 will create a new note. For customizing the shortcut see Keyboard Shortcuts section.

Opening an existing note (F4)

  • Command palette: Open command palette and search for Notes: Listโ€ฆ command (typing nl 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.

Jotter (F1)

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"
}

Notes Index Card (ctrl+F4)

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

More Repositories

1

PlainTasks

An opinionated todo-list plugin for Sublime Text editor (version 2 and 3)
Python
3,280
star
2

tmTheme-Editor

Color scheme editor for SublimeText, Textmate and a bunch of other text editors
HTML
1,680
star
3

SublimeFileBrowser

Ditch sidebar and browse your files in a normal tab with keyboard, like a pro!
Python
394
star
4

SublimeANSI

ANSI escape codes color highlighting for SublimeText 3
Python
218
star
5

SublimeHyperClick

Quickly and easily jump between your files. The missing part of Go to definition functionality in Sublime.
Python
211
star
6

dotfiles

My Unix environment
Shell
162
star
7

BetterFindBuffer

Adds a couple of missing features to SublimeText 3 Find Results buffer
Python
107
star
8

knockdown

Github flavored Markdown for SublimeText and a custom theme for writing markdown
JavaScript
89
star
9

GoogleReader-OSXLionUI

REST IN PEACE GOOGLE READER! A user style for new google reader UI that makes you feel right at home
JavaScript
89
star
10

virastar

cleanning up Persian text!
Ruby
82
star
11

DistractionFreeWindow

SublimeText "Distraction free mode" but not full-screen! A windowed UI is more manageable and accessible yet it can be simple and sublime!
Python
45
star
12

jalalidate

A library for working with Jalali Calendar (a.k.a Persian Calendar)
Ruby
41
star
13

SublimeSyntaxConvertor

Converts tmLanguage to sublime-syntax
Ruby
36
star
14

farsifu

A toolbox for developing ruby applications in Persian (Farsi) language, see readme for features
Ruby
23
star
15

SublimeSyncedSidebarBg

Changes the sidebar theme based on active view's color scheme
Python
14
star
16

sublimeText3-Userfiles

My text-editor config files
Python
14
star
17

sublimeText2-Userfiles

I'm not updating this repo anymore, I've moved to SublimeText 3 https://github.com/aziz/sublimeText3-Userfiles
Python
12
star
18

sublime-mini-ui

HTML
10
star
19

tmTheme-Editor-Parser

Ruby
5
star
20

Things

A online replica of awesome Mac OSX task management app Things, a personal practice for development of desktop like applications
JavaScript
4
star
21

html5-slides-rtl

This is a fork of google's html5slides project with right to left support
JavaScript
3
star
22

PlasticAB

Porting my plasticCodeWrap textmate/sublime color-scheme to vs-code
3
star
23

sublime-history

Python
2
star
24

latex-template

my personal latex templates
TeX
2
star
25

pingilish

Converting Farsi to Pingilish (Farsi written in Latin alphabets) and Pingilish to Farsi
2
star
26

SublimeCucumberSteps

Python
1
star
27

atom-plastic-code-wrap-syntax

CSS
1
star
28

SublimeTheme

JavaScript
1
star
29

ignore_words

Ignore words for spell check in Sublime 3
Python
1
star
30

textmate

All textmate bundles I use, managed by git submodules
Ruby
1
star
31

parsmark

Persian flavour of MultiMarkdown
1
star