_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


## 22. Asciidoc markup

Asciidoc markup is a system for formatting text, adding media, making hyperlinks and cross references, etc. Here is an example.

This text is bold this text is italic.

Here is what we wrote to achieve this:

`This text is *bold* this text is _italic_.`

Below we say more about markup. See asciidoctor.org for much more complete information.

### 22.1. Why Markup?

Markup goes against the prevailing ideology of WYSIWIG editing. But for authors who need to write a lot of structured text, markup has many advantages. First and foremost, you can write quickly and keep focused on what you want to express instead of breaking the flow by swtiching back and forth between keyboard, mouse, and menu. Using markup requires a small (surprisingly small) up-front investment in learning a new tool, but that investment will repay itself many times over as you write. See the section More Asciidoc Examples below to get started.

Second, markup can render text into many other formats: html (the web pages you see here), docbook, pdf, etc.

### 22.2. PDF

For some kinds of content, PDF is the way to go. In the New Course | Lesson | PDF menu, select PDF to create a new PDF file and attach it to a lesson.

To make a link to another VSchool lesson, all you need is its ID number. Here is a link: scientific method. It was created this way:

`LITERAL::http://www.noteshare.io/lessons/999[Scientific method]`

Look for the lesson ID in the upper right of the gray banner.

### 22.4. More Asciidoc Examples

Verse

```Twas brillig, and the slithy toves
Did gyre and gimble in the wabe:
All mimsy were the borogoves,
And the mome raths outgrabe```

To achieve this, we wrote

```....
Twas brillig, and the slithy toves
Did gyre and gimble in the wabe:
All mimsy were the borogoves,
And the mome raths outgrabe
....```

There are many markup codes, but you will need just a few for most of what you do.

```== Level 1 heading

Lists

1. Apples

2. Pears

3. Bananas

```. Apples
. Pears
. Bananas```
• Apples

• Pears

• Bananas

```- Apples
- Pears
- Bananas```

`http:://nytimes.com[New York Times]`