_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
• 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
• 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
• 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
• 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
• 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.4 More Asciidoc Exampleshttp://www.noteshare.io/section/asciidoc-markup?part=More%20Asciidoc%20Examples#_more_asciidoc_examples

# Noteshare Handbook


## 3. Markup Basics

In this section we go over the markup codes that you will most likely need when starting out — italic, bold, highlighted and strikethough text, lists, tables, references to web pages, images, and structuring a document into sections, subsections, and so on. We then discuss block constructs — quotations, verse, code, verbatim, etc.

In each case, we give references to more comprehensive sources.

### 3.1. First things first

Italic text

He shouted, this is very important!

`He shouted, _this is very important!_`
Bold text

He shouted, this is very important!

`He shouted,  *this is very important!*`
Highlighted text

Psychologists believe that marking up selected parts of a long text improves comprehension and memory. Sometimes the use of color can differentiate different kinds of text.

Strikethrough

Ms. Grundy made the following correction: "Dear teacher. I ain’t gonna like this class. Can I be excused?"

Numbered Lists

You write a numbered list of errands:

1. Get groceries

2. Put gas in the car

3. Drop a package off at Fedex

Here is the marked-up text:

```. Get groceries
. Put gas in the car
. Drop a package off at Fedex```
Bulleted lists

You are writings an outline for a class presentation:

• Atoms are the building blocks of matter

• Atoms are very, very small

• The idea goes back to Democritus, around 500 BC

• We now know that atoms can be broken down into smaller particles

Here is the marked up text:

```* Atoms are the building blocks of matter
* Atoms are very, very small
* The idea goes back to Democritus, around 500 BC
* We now know that atoms can be broken down
into smaller particles```

Here is the marked-up text:

```You want to link to an article about
https://en.wikipedia.org/wiki/Niels_Bohr[Niels Bohr]```

Just paste in the link and follow it by a few words enclosed in brackets. Some times the links are so long that you have to choose the Wide option in the Edit menu.

Media

Noteshare documents can display media: images, audio, and text. The image below was inserted using the markup

image ::460[]

### 3.2. Sections

Section, subsections, etc., are indicated like this:

``` == Top level section

Blah, blah

=== Subsection

Fee, fie, fo fum!

==== Subsection

Ho ho ho!

===== Subsubsubsection

The end!```

Sections can be numbered or un-numbered.

Put the code :numbered: in your document to turn numbering on, put :!numbered: to turn it off.

### 3.3. Blocks

Blocks are used for quotations, poetry, computer code, and much more. The general form of a one-paragraph block is

```[header]
TEXT```

The general form of a several-paragraph block is

```[header]
--
PARAGRAPH 1

PARAGRAPH 2

ETC
--```

We illustrate this construction below.

#### 3.3.1. Verse

Poem — one paragraph
```’Twas brillig, and the slithy toves
Did gyre and gimble in the wabe:
All mimsy were the borogoves,
And the mome raths outgrabe.```
Markup
```[verse]
’Twas brillig, and the slithy toves
Did gyre and gimble in the wabe:
All mimsy were the borogoves,
And the mome raths outgrabe.```
Poem — several paragraphs
```’Twas brillig, and the slithy toves
Did gyre and gimble in the wabe:
All mimsy were the borogoves,
And the mome raths outgrabe.

“Beware the Jabberwock, my son!
The jaws that bite, the claws that catch!
Beware the Jubjub bird, and shun
The frumious Bandersnatch!”```
Markup
```[verse]
--
’Twas brillig, and the slithy toves
Did gyre and gimble in the wabe:
All mimsy were the borogoves,
And the mome raths outgrabe.

“Beware the Jabberwock, my son!
The jaws that bite, the claws that catch!
Beware the Jubjub bird, and shun
The frumious Bandersnatch!”
--```

#### 3.3.2. Quotations

A man who dares to waste one hour of time has not discovered the value of life.
— Charkes Darwin
The Autobiography of Charles Darwin
Markup
```[quote, Charkes Darwin, The Autobiography of Charles Darwin, 1809–82]
A man who dares to waste one hour of time has
not discovered the value of life.```

#### 3.3.3. Code

Below is a a block of code; note that indentation is preserved:

``````sum = 0.0
for k in range(1,100):
sum = sum + 1.0/k``````
Markup
```[source, python]
--
sum = 0.0
for k in range(1,100):
sum = sum + 1.0/k
--```

### 3.4. Basic tables

 Eggs one dozen Potatoes twelve pounds Milk three quarts

The source code
```|===
| Eggs | one dozen
| Potatoes | nine pounds
| Milks | three quarts
|===```

For more, see the tables section of this manual.

Created August 21, 2015, last updated: August 22, 2015