AsciiDoc3 cheatsheet v1.0

Level 1
 ------
Text here!

Level 2
~~~~~~~
More text.

Level 3
^^^^^^^
More and more text.

Level 4
+++++++
This is the end.

[red]#red text# [yellow-background]#on yellow#
[big]#large# [red yellow-background big]*all bold*

forced +
line break

normal, _italic_, *bold*, +mono+.

``double quoted'', `single quoted'.

normal, ^super^, ~sub~.

Command: `ls -al`

+mono *bold*+

`passthru *bold*`

Path: '/some/filez.txt', '.b'

Chars: n__i__**b**++m++[red]##r##

// Comment

(C) (R) (TM) -- ... -> <- => <= &#182;

''''

Escaped:
\_italic_, +++_italic_+++,
t\__e__st, +++t__e__st+++,
+++<b>bold</b>+++, $$<b>normal</b>$$
\&#182;
\`not single quoted'
\`\`not double quoted''

[underline]#Underline text#, [overline]#overline text# and
[blue line-through]*bold blue and line-through*.

and now the tiger image:../images/tiger.png[alt="Tiger",height=35] comes along.

image::../images/tiger.png["Tiger image",height=40, align="right"]

.Optional Title

Usual
paragraph.

.Optional Title

 Literal paragraph.
  Must be indented.

.Optional Title

[source,python]
print('hello again')

This is normal text.

print('hello again')

.Optional Title
NOTE: This is an example
      single-paragraph note.

.Optional Title
[NOTE]
This is an example
single-paragraph note.

TIP: Tip.

IMPORTANT: Important.

WARNING: Warning.

CAUTION: Caution.

.Optional Title
 ----                  
*Listing* Block

Use: code or file listings
 ----                  

*Listing* Block

Use: code or file listings

.Optional Title
[source,perl]
 ----              
# *Source* block
# Use: highlight code listings
# (require `source-highlight` or `pygmentize`)
use DBI;
my \$dbh = DBI->connect('...',\$u,\$p)
    or die "connect: \$dbh->errstr";
 ----              

# *Source* block
# Use: highlight code listings
# (require `source-highlight` or `pygmentize`)
use DBI;
my $dbh = DBI->connect('...',$u,$p)
    or die "connect: $dbh->errstr";

.Optional Title
****
*Sidebar* Block

Use: sidebar notes :)
****

.Optional Title
==========================
*Example* Block

Use: examples :)

Default caption "Example:"
can be changed using

 [caption="Custom: "]

before example block.
==========================

.Optional Title
[NOTE]
===============================
*NOTE* Block

Use: multi-paragraph notes.
===============================

////
*Comment* block

Use: hide comments
////

++++
*Passthrough* Block
<p>
Use: backend-specific markup like
<table border="1">
<tr><td>1<td>2</tr>
</table>
++++

 .Optional Title
 ....
 *Literal* Block

 Use: workaround when literal
 paragraph (indented) like
   1. First.
   2. Second.
 incorrectly processed as list.
 ....

.Optional Title
[quote, cite author, cite source]
____
*Quote* Block

Use: cite somebody. To be or not to be ...
____

.Bulleted
* bullet
* bullet
  - bullet
  - bullet
* bullet
** bullet
** bullet
*** bullet
*** bullet
**** bullet
**** bullet
***** bullet
***** bullet
**** bullet
*** bullet
** bullet
* bullet

.Bulleted 2
- bullet
  * bullet

[horizontal]
.Labeled horizontal
Term 1:: Definition 1
Term 2:: Definition 2
[horizontal]
    Term 2.1;;
        Definition 2.1
    Term 2.2;;
        Definition 2.2
Term 3::
    Definition 3
Term 4:: Definition 4
[horizontal]
Term 4.1::: Definition 4.1
Term 4.2::: Definition 4.2
[horizontal]
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

.Title
[width="15%"]
|=======
|1 |2 |A
|3 |4 |B
|5 |6 |C
|=======

.An example table with title, header and footer
[width="40%",frame="topbot",options="header,footer"]
|======================
|Column 1 |Column 2
|1        |Item 1
|2        |Item 2
|3        |Item 3
|6        |Three items
|======================

.Spans, alignments and styles
[cols="e,m,^,>s",width="25%"]
|================
|1 >s|2 |3 |4
^|5 2.2+^.^|6 .3+<.>m|7
^|8
|9 2+>|10
|================