Encode your data without syntax.


Note is a simple language, designed for both humans and programmers, that makes it easy to read, write, edit, and share objects.

Here's how I could encode an object named Earth:

 age 4,540,000,000yrs
 moons 1
 population 6,973,738,433
 radius 6.371km

This same object, written in the current dominant object notation, JSON, might look like this:


In both examples, this object has a property "moons" that has a value of "1", and has a property population that has a value of "6,973,738,433". In Javascript, I could access the population property like this:


Notice that while the behavior is close to identical, the Note encoding is much simpler, cleaner, and durable than the JSON encoding.

Note has just a few rules involving spaces and new lines that makes the whole thing work. Note has two, and only 2, special characters:

  1. The Space Character.
  2. The New Line Character.

A Note object is simply a list of name/value pairs. A single space character(" ") separates the name and value. A new line separates pairs. Names are always strings. Names can contain any character except space or newline. Values can be either strings or Note objects and can contain any character.

Note is great for web APIs. Anywhere JSON or XML is used, Note is probably a better choice. Note is very similar to JSON without the syntax and without the types.

Note does not care what programming language you use. Although the implementation of Note included here is built in Javascript, Note can be read, written, and modified easily with any programming language. In fact, one of the main benefits of Note is that it can be used by many programs, with many different languages, and they can all easily share data using Note.


In the Note object above, "email" is a name, and "" is the corresponding value.

gender male

In the Note object above, "email" and "gender" are names, and "" and "male" are the corresponding values.

You can set values as strings like in the examples above, or you can set values to be nested Note objects by putting a newline immediately after the name and by indenting each item in the nested Note object by 1 space.

gender male
 home 555-5555
 cell 444-4444

In this example, the value of phone_numbers is itself another Note object.

gender male
 home 555-5555
 cell 444-4444
 This is my bio.
 It it written on multiple lines.
 There is a space after biography above, which instructs the code that this is
 a multiline string, and not a nested Note object.
 The end.

Values can be multiline strings by adding a space after the name (in this case "biography") and indenting the additional lines by one space.

Open example.html for a very basic usage example.

  • Besides spaces and new lines, there are no syntax characters in Note.
  • The difference between 2 notes is a note.
  • There is no such thing as a syntax error in Note.

Although Note has no types and very few features, you can easily build encodings on top of Note that do have types and additional features.

For example, you could build a class called Person, that extends note, and expects age to be an integer.

We've built an encoding on top of Note called Blocks, that works as powerful template language for HTML. We've also built an encoding that can turn a full filesystem into Note and vice versa, using base64 encoding of binary data.

The Javascript library in this repo works in both the browser and with Node.js.

The API is still somewhat in flux, but there are many neat methods such as diff, patch, and toString that demonstrate the power of Note.

If you'd like to contribute please contact me at

Feel free to contact me at for help using or extending Note.

This object, with spaces in the name, cannot be represented in Note:

{ "This name has a space" : "value" }

To get around this you could rename the name, or use camelCasing or underscores instead of spaces.


is equivalent to


If order is important for your application, you must specify the numbers:

 1 joe
 2 bob
 3 sam

The reason for this decision was to ensure that the difference between 2 notes is itself note.

Note was inspired by JSON and HAML, and our desire for a simpler, more universal object encoding with less syntax.