Asciidoctor Sample File

Bookmarks and Cross References

See the end of the file for links back.

bookmark-a: Inline anchors make arbitrary content referenceable.

bookmark-b: Inline anchors can be applied to a phrase like this one.

bookmark-c: Use a cross reference to link to this location.

bookmark-d: The xreflabel attribute will be used as link text in the cross-reference link.

Jump to Xref Links

Text

normal; _italic_; *bold*; +mono+

normal; italic; bold; mono

''double quoted''; 'single quoted'

normal; ^super^; ~sub~.

normal; ^super; _sub

[.overline]#overline#

overline

[.underline]#underline#

underline

[.line-through]#line-through#

line-through

Alignment

Tip	Sidebars (callouts) can contain any type of content.

Align the text of a paragraph

To align the text of a paragraph, use the following syntax:

[.text-<alignment>] +  /* start a row with a space to make it code */
Text to align...

Where <alignment> is one of the following: left, center, right or justify. See examples below:

[.text-left] will left-justify the text.

[.text-center] will center the text.

[.text-right] will right-justify the text.

[.text-justify] There are modern bibles based on the Textus Receptus (such as the NKJV and MEV), but in many places they miss the mark. They took verses that didn’t need to change and changed them. Sometimes making them more difficult to read than the KJV. I suspect this was due to a need to have ample changes so a copyright could be claimed.

Note that the last line of a 'justify' alignment is not justified.

[.small] There are modern bibles based on the Textus Receptus (such as the NKJV and MEV), but in many places they miss the mark. They took verses that didn’t need to change and changed them. Sometimes making them more difficult to read than the KJV. I suspect this was due to a need to have ample changes so a copyright could be claimed.

[.big] There are modern bibles based on the Textus Receptus (such as the NKJV and MEV), but in many places they miss the mark. They took verses that didn’t need to change and changed them. Sometimes making them more difficult to read than the KJV. I suspect this was due to a need to have ample changes so a copyright could be claimed.

[.huge] There are modern bibles based on the Textus Receptus (such as the NKJV and MEV), but in many places they miss the mark. They took verses that didn’t need to change and changed them. Sometimes making them more difficult to read than the KJV. I suspect this was due to a need to have ample changes so a copyright could be claimed.

Colors

The basic colors are 16 colors defined in the HTML 4.01 specification, ratified in 1999,[8] as follows (names are defined in this context to be case-insensitive):

White

#FFFFFF

[white black-background]#White on black#

White on black

Silver

#C0C0C0

[silver maroon-background]#Silver on maroon#

Silver on maroon

Gray

#808080

[gray lime-background]#Gray on lime#

Gray on lime

Black

#000000

[black green-background]#black on green#

Black on green

Red

#FF0000

[red silver-background]#Red on silver#

Red on silver

Maroon

#800000

[maroon aqua-background]#Maroon on aqua#

Maroon on aqua

Yellow

#FFFF00

[yellow teal-background]#Yellow on teal#

Yellow on teal

Olive

#808000

[olive navy-background]Olive on navy#

Olive on navy

Lime

#00FF00

[lime blue-background]#Lime on blue#

Lime on blue

Green

#008000

[green silver-background]#Green on silver#

Green on silver

Aqua

#00FFFF

[aqua purple-background]#Aqua on purple#

Aqua on purple

Teal

#008080

[teal fuchsia-background]#Teal on fuchsia#

Teal on fuchsia

Blue

#0000FF

[blue gray-background]#Blue on gray#

Blue on gray

Navy

#000080

[navy red-background]#Navy on red#

Navy on red

Fuchsia

#FF00FF

[fuchsia yellow-background]#Fuchsia on yellow#

Fuchsia on yellow

Purple

#800080

[purple olive-background]#Purple on olive#

Purple on olive

Source: Wikipedia

Formatting

'''' Produces a section divider line, as below:

There must be a space directly above '''' the line.

This is a paragraph styled as a lead paragraph (slightly larger font).

This is a normal paragraph, regardless of its position in the document.

Use a -- Block

To set a large background area.

Sidebars (Callouts)

This code:

.Optional Title
****
Sidebars are used to visually separate auxiliary bits of content
that supplement the main text.

TIP: They can contain any type of content.

.Source code block in a sidebar
[source,js]
----
const { expect, expectCalledWith, heredoc } = require('../test/test-utils')
----
****

Produces this sidebar:

Optional Title

Sidebars are used to visually separate auxiliary bits of content that supplement the main text.

Tip	They can contain any type of content.

Source code block in a sidebar

const { expect, expectCalledWith, heredoc } = require('../test/test-utils')

Include Raw HTML

++++
include::some_file.html[]
++++

Adding empty lines around this prevents interpretation of the included file contents as continuations of the adoc text surrounding the include, as described in the manual.

Tables

You can fill table from CSV file using include: macros inside table.

Table 1. An example table
Col 1	Col 2	Col 3
1	Item 1	a
2	Item 2	b
3	Item 3	c
6	Three items	d

Table 2. CSV data, 15% each column
1	2	3	4	5	6
a	b	c	d	e	f
A	B	C	D	D	E

ID FName LName Address Phone

ID	FName	LName	Address	Phone
1	Vasya	Pupkin	London	`+123`
2	X	Y	A,B	`45678`

1

Vasya

Pupkin

London

+123

2

X

Y

A,B

45678

Table 3. Multiline cells, row/col span
Date	Duration	Avg HR	Notes
22-Aug-08	10:24	157	Worked out MSHR (max sustainable heart rate) by going hard for this interval.
22-Aug-08	10:24	152	Back-to-back with previous interval.
24-Aug-08	none

Lists

Bullets

bullet
bullet
- bullet
- bullet
bullet
- bullet
- bullet
  - bullet
  - bullet
    
    bullet
    
    bullet
    
    bullet
    
    bullet
    
    bullet
  - bullet
- bullet
bullet

Ordered

number
number
1. letter
2. letter
number
1. loweralpha
2. loweralpha
  1. lowerroman
  2. lowerroman
    
    upperalpha
    
    upperalpha
    
    upperroman
    
    upperroman
    
    upperalpha
  3. lowerroman
3. loweralpha
number

Labeled

Term 1

Definition 1

Term 2

Definition 2

Term 2.1: Definition 2.1
Term 2.2: Definition 2.2

Term 3

Definition 3

Term 4

Definition 4

Term 4.1

Definition 4.1

Term 4.2

Definition 4.2

Term 4.2.1: Definition 4.2.1
Term 4.2.2: Definition 4.2.2

Term 4.3

Definition 4.3

Term 5

Definition 5

Horizontal

Labeled horizontal

Term 1: Definition 1
Term 2: Definition 2

Term 2.1	Definition 2.1
Term 2.2	Definition 2.2 Term 3 Definition 3 Term 4 Definition 4

Term 4.1	Definition 4.1
Term 4.2	Definition 4.2

Term 4.2.1	Definition 4.2.1
Term 4.2.2	Definition 4.2.2 Term 4.3 Definition 4.3 Term 5 Definition 5

Question and Answer

Question 1: Answer 1
Question 2: Answer 2

List Continuation

bullet continuation
1. number continuation
  - bullet
    
    literal continuation
    
    letter
    
    Non-literal continuation.
    
    any block can be included in list
    
    Last continuation.

Level 1 Section Titles

Level 2 Section Title

Level 3 Section Title

Level 4 Section Title

Level 5 Section Title

Xref Links

Section Titles such as Xref Links above are automatically converted to book marks.

Jump to [bookmark-a] Jump to [bookmark-b] Jump to [bookmark-c] Jump to last paragraph