_pub.n

• 2.1 Create a notebookhttp://www.noteshare.io/section/asciidoc-101?part=Create%20a%20notebook#_create_a_notebook
• 2.2 Create a new sectionhttp://www.noteshare.io/section/asciidoc-101?part=Create%20a%20new%20section#_create_a_new_section
• 2.3 Imageshttp://www.noteshare.io/section/asciidoc-101?part=Images#_images
• 2.4 Manage notebookhttp://www.noteshare.io/section/asciidoc-101?part=Manage%20notebook#_manage_notebook
• 2.5 Collaborationhttp://www.noteshare.io/section/asciidoc-101?part=Collaboration#_collaboration
• 2.6 Exporthttp://www.noteshare.io/section/asciidoc-101?part=Export#_export
• 3.1 First things firsthttp://www.noteshare.io/section/markup-basics?part=First%20things%20first#_first_things_first
• 3.2 Sectionshttp://www.noteshare.io/section/markup-basics?part=Sections#_sections
• 3.3 Blockshttp://www.noteshare.io/section/markup-basics?part=Blocks#_blocks
• 3.4 Basic tableshttp://www.noteshare.io/section/markup-basics?part=Basic%20tables#_basic_tables
• 4.5 Math Homeworkhttp://www.noteshare.io/section/math-homework?part=Math%20Homework#_math_homework
• 4.6 Chemistryhttp://www.noteshare.io/section/math-homework?part=Chemistry#_chemistry
• 5.1 Browse menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Browse%20menubar#_browse_menubar
• 5.2 Read menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Read%20menubar#_read_menubar
• 5.3 Write menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Write%20menubar#_write_menubar
• 5.4 Media menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Media%20menubar#_media_menubar
• 6.1 Creating a Notehttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Creating%20a%20Note#_creating_a_note
• 6.2 Editing a Notehttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Editing%20a%20Note#_editing_a_note
• 6.3 Markup 102http://www.noteshare.io/section/creating-notes-and-notebooks?part=Markup%20102#_markup
• 6.4 Creating a notebookhttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Creating%20a%20notebook#_creating_a_notebook
• 7.1 A simple tablehttp://www.noteshare.io/section/tables-?part=A%20simple%20table#_a_simple_table
• 7.2 A formatted tablehttp://www.noteshare.io/section/tables-?part=A%20formatted%20table#_a_formatted_table
• 7.3 A table with a headerhttp://www.noteshare.io/section/tables-?part=A%20table%20with%20a%20header#_a_table_with_a_header
• 7.4 A table with a header and footerhttp://www.noteshare.io/section/tables-?part=A%20table%20with%20a%20header%20and%20footer#_a_table_with_a_header_and_footer
• 8.1 References within a notehttp://www.noteshare.io/section/cross-references-2?part=References%20within%20a%20note#_references_within_a_note
• 8.2 References within Notesharehttp://www.noteshare.io/section/cross-references-2?part=References%20within%20Noteshare#_references_within_noteshare
• 8.3 References to a web pagehttp://www.noteshare.io/section/cross-references-2?part=References%20to%20a%20web%20page#_references_to_a_web_page
• 8.4 References to something inside a web pagehttp://www.noteshare.io/section/cross-references-2?part=References%20to%20something%20inside%20a%20web%20page#_references_to_something_inside_a_web_page
• 9.1 Syntaxhttp://www.noteshare.io/section/mathematical-notation?part=Syntax#_syntax
• 10.1 Exampleshttp://www.noteshare.io/section/chemistry?part=Examples#_examples
• 10.2 Structural formulashttp://www.noteshare.io/section/chemistry?part=Structural%20formulas#_structural_formulas
• 10.3 Referenceshttp://www.noteshare.io/section/chemistry?part=References#_references
• 14.1 Check-in and check-outhttp://www.noteshare.io/section/collaboration?part=Check-in%20and%20check-out#_check_in_and_check_out
• 14.4 Authorship of commentshttp://www.noteshare.io/section/comments?part=Authorship%20of%20comments#_authorship_of_comments
• 15.1 Attributeshttp://www.noteshare.io/section/extras?part=Attributes#_attributes
• 16.1 Notes on the embed featurehttp://www.noteshare.io/section/test-of-embed-feature?part=Notes%20on%20the%20embed%20feature#_notes_on_the_embed_feature
• 17.1 Standard accounthttp://www.noteshare.io/section/noteshare-advanced-features?part=Standard%20account#_standard_account
• 17.2 Premium accounthttp://www.noteshare.io/section/noteshare-advanced-features?part=Premium%20account#_premium_account
• 17.3 In the pipelinehttp://www.noteshare.io/section/noteshare-advanced-features?part=In%20the%20pipeline#_in_the_pipeline
• 20.1 Problem sets, etc.http://www.noteshare.io/section/technical-appendix?part=Problem%20sets,%20etc.#_problem_sets_etc
• 20.2 Quiz #1http://www.noteshare.io/section/technical-appendix?part=Quiz%20#1#_quiz
• 20.3 Quiz #2http://www.noteshare.io/section/technical-appendix?part=Quiz%20#2#_quiz
• 20.4 Technical notehttp://www.noteshare.io/section/technical-appendix?part=Technical%20note#_technical_note
• 21.1 The Quadratic Equationhttp://www.noteshare.io/section/linking-the-main-page-and-the-aside?part=The%20Quadratic%20Equation#_the_quadratic_equation
• 21.2 The Cubic equationhttp://www.noteshare.io/section/linking-the-main-page-and-the-aside?part=The%20Cubic%20equation#_the_cubic_equation
• 22.1 Why Markup?http://www.noteshare.io/section/asciidoc-markup?part=Why%20Markup?#_why_markup
• 22.2 PDFhttp://www.noteshare.io/section/asciidoc-markup?part=PDF#_pdf
• 22.3 Links between lessonshttp://www.noteshare.io/section/asciidoc-markup?part=Links%20between%20lessons#_links_between_lessons
• 22.4 More Asciidoc Exampleshttp://www.noteshare.io/section/asciidoc-markup?part=More%20Asciidoc%20Examples#_more_asciidoc_examples

Noteshare Handbook

This notebook needs to be udpated — many improvements to Noteshare since it was written.


1. What is NoteShare?

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

Your Noteshare.io Account

When you sign up for Noteshare, you get a web paged linked to your screen name. Thus John Doe, who set up his account as jdoe@foo.com, has the site jdoe.my.noteshare.io. The public version of John’s site — whose content is available to his grandmother and everyone else — is jdoe.my.noteshare.io/public. That’s the web address to give to your family, fans, co-workers, students, etc.

Figure 1. Bird
Markup

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: *Boldface*.

See the Markup 101 section of this handbook for more examples — how to make lists and charts, place hyperlinks like this article on atoms, how to place images like the one of the bird you see on the right, and even how to write mathematical formulas like $\sqrt{a^2 + b^2}$. For still more examples, take a look at this sample document.

Technical stuff and roadmap

Noteshare.io is based on the powerful Asciidoctor text processing and rendering engine. A forthcoming update will allow you to compile a Noteshare document which you create into other formats: PDF, epub3 (electronic book), or LaTeX.

Created June 3, 2014, last updated: September 1, 2015

Troubleshooting

If Noteshare is not responsive, try refreshing your browser. Questions and comments to noteshare.io@gmail.com.

View Source

To compare the source and rendered text, choose Source from the View menu. This is good way to learn Asciiidoc markup — apply your natural reverse-engineernig skills.

Aside

Every Noteshare "page" has a companion page, the Aside, which you can choose to use or not. Asides can contain explanations, references, images, anything you want.

If a section of your notebook has no Aside, you won’t see anything here.

To create or edit an Aside, choose Write in the menu bar. Then in Part, choose Aside

Noteshare also offers clickable headers. They are typically rendered with blue text. Click once to reveal content, click again to hide. Go to xlink::856 to see how to make a clickable header.