Title page | James Carlson

Collapse Share Open book
  • 3.1 Navigation barhttp://epsilon.my.noteshare.io/section/overview?part=Navigation%20bar#_navigation_bar
  • 3.2 Menushttp://epsilon.my.noteshare.io/section/overview?part=Menus#_menus
  • 3.3 Buttons and keyboard shortcutshttp://epsilon.my.noteshare.io/section/overview?part=Buttons%20and%20keyboard%20shortcuts#_buttons_and_keyboard_shortcuts
  • 4.1 Create a notebookhttp://epsilon.my.noteshare.io/section/uuu-getting-started-0e619a29-3f90-453a-8bf4-c3026dcb1335?part=Create%20a%20notebook#_create_a_notebook
  • 4.2 Create a new sectionhttp://epsilon.my.noteshare.io/section/uuu-getting-started-0e619a29-3f90-453a-8bf4-c3026dcb1335?part=Create%20a%20new%20section#_create_a_new_section
  • 5.1 Ordinary texthttp://epsilon.my.noteshare.io/section/creating-content?part=Ordinary%20text#_ordinary_text
  • 5.2 Marked up texthttp://epsilon.my.noteshare.io/section/creating-content?part=Marked%20up%20text#_marked_up_text
  • 5.3 Listshttp://epsilon.my.noteshare.io/section/creating-content?part=Lists#_lists
  • 5.4 Links and cross-referenceshttp://epsilon.my.noteshare.io/section/creating-content?part=Links%20and%20cross-references#_links_and_cross_references
  • 5.5 Imageshttp://epsilon.my.noteshare.io/section/creating-content?part=Images#_images
  • 5.6 Sectionshttp://epsilon.my.noteshare.io/section/creating-content?part=Sections#_sections
  • 5.7 Blockshttp://epsilon.my.noteshare.io/section/creating-content?part=Blocks#_blocks
  • 5.8 Tableshttp://epsilon.my.noteshare.io/section/creating-content?part=Tables#_tables
  • 6.1 Commenting outhttp://epsilon.my.noteshare.io/section/writing-tools?part=Commenting%20out#_commenting_out
  • 6.2 Glossaryhttp://epsilon.my.noteshare.io/section/writing-tools?part=Glossary#_glossary
  • 6.3 Bibliographyhttp://epsilon.my.noteshare.io/section/writing-tools?part=Bibliography#_bibliography
  • 6.4 Indexhttp://epsilon.my.noteshare.io/section/writing-tools?part=Index#_index
  • 6.5 Exporthttp://epsilon.my.noteshare.io/section/writing-tools?part=Export#_export
  • 8.1 Viewing a grouphttp://epsilon.my.noteshare.io/section/collaboration-and-managing-groups?part=Viewing%20a%20group#_viewing_a_group
  • 8.2 Managing a grouphttp://epsilon.my.noteshare.io/section/collaboration-and-managing-groups?part=Managing%20a%20group#_managing_a_group
  • 8.3 Checking documents outhttp://epsilon.my.noteshare.io/section/collaboration-and-managing-groups?part=Checking%20documents%20out#_checking_documents_out
  • 10.1 Inline and displayed formulashttp://epsilon.my.noteshare.io/section/mathematics?part=Inline%20and%20displayed%20formulas#_inline_and_displayed_formulas
  • 10.2 Theoremshttp://epsilon.my.noteshare.io/section/mathematics?part=Theorems#_theorems
  • 10.3 Equation environmenthttp://epsilon.my.noteshare.io/section/mathematics?part=Equation%20environment#_equation_environment
  • 10.4 Macroshttp://epsilon.my.noteshare.io/section/mathematics?part=Macros#_macros

Up and Running With Noteshare

\( \(\) \)
If you want to get started writing right away, skip to Section 4 and Section 5 now.

1. What is Noteshare?

Noteshare.io is a tool for creating and sharing online notebooks. Here are some examples:

Figure 1. Bird

Notebooks can be for private use, shared with a group, or open to all. Subject matter — educational, literary, artistic, scientific, technical, whatever — depends entirely on your needs and interests. Notebooks are built with the written word — prose, verse, lists, quotes, links to web pages, etc. They can can contain images, other media, and even interactive widgets. (Javascript apps) Mathematical and chemical formulas are also supported (via standard LaTeX): We cannot understand \(\ce{ H2O }\) without the Schrödinger equation:

\[ - \frac{\hbar^2}{2m} \frac{\partial^2 \psi}{\partial x^2}+ V\psi = i\hbar \frac{\partial \psi}{\partial t} \] (1)

(Ask Niels Bohr about that one).

Noteshare also provides tools for cross-referencing, glossaries, an index, and bibliographies. Notebooks can be downloaded to your computer and can, of course, be printed from Noteshare itself.

Not a Blog

Blogs are a great medium for publishing short articles organized by time and perhaps complemented by a system of categories and tags and a search engine. Noteshare addresses the need to publish book-like material on the web, in which material is organized by topic with chapters, sections, and subsections which can be re-organized and re-ordered as the material develops. Noteshare notebooks are online books, and are written in a format (Asciidoc markup) that makes it easy to publish them as a physical book. This format is used, for example, by O’Reilly.

Noteshare also provides tools for tagging and searching, including full-text search. (Some features, such as full-text search, will be limited to paid users at a future date. Be assured that even for pro users, rates will be reasonable. After all, we are writers!)

Your Noteshare.io Account

When you sign up for Noteshare, you get a web paged linked to your screen name. If your screen name is jdoe, then your Noteshare.io site is jdoe.my.noteshare.io. Share the public content of that site using jdoe.my.noteshare.io/public.

There are also non-personal, curated Noteshare sites such as essays.noteshare.io, code.noteshare.io, math.noteshare.io, etc., on which your work can be cross-published. Contact noteshare.io@gmail.com if you are interested in publishing your work on such a site or are interested in setting up such a site.


Noteshare documents are written in Asciidoc, a markup language. "Markup" means that you add little codes to your text to structure it and shape its appearance. For example, to obtain italic text, you write

    _something like this_

The underscore character _ is the markup code. Boldface is done in a similar way:


We explain the basics of markup in the section creating content.`

Your Noteshare.io account comes with a two-pane editor. On the left is the markup — the source text that you write. On the right is the rendered text — the text that your fans read.

As noted above, Noteshare supports mathematical notation. It provides Asciidoc-LaTeX, an extension of Asciidoc. With it, you can produce rendered text like \(a^2 + b^2 = c^2\), by writing the markup

    $ a^2 + b^2 = c^2 $

This is standard LaTeX. See this section for more information.


If you want to get started writing, skip to Section 4 and Section 5 now.

Goals and Roadmap

Noteshare.io is still in public beta. Our goals are to provide

  • A tool for writing structured documents

    • with high esthetic value

    • that can transformed automatically into a variety of formats: HTML for the Web, PDF for print, etc.

  • A searchable system for publishing online — one that gives students and teachers, readers and writers a way to find eachother.

  • A system for developing an organized, well-curated, high-quality store of knowledge — from lecture notes to works of art and fiction — that are freely available and in the public domain.

Technology note

Noteshare.io is based on Asciidoctor, a fast and versatile open-source text processing program for the Asciidoc markup language. Asciidoctor is the center of an active ecosystem of text and publishing tools, and is used by organizations such as GitHub and O’Reilly Publishing.

Contact: noteshare.io@gmail.com
This document on Noteshare.io

Created August 23, 2015, last updated: October 9, 2015