Skip to content

Instantly share code, notes, and snippets.

@eirnym

eirnym/AsciidocCheatsheet.adoc

Forked from powerman/AsciidocCheatsheet.adoc
Created March 14, 2021 11:51
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save eirnym/0915511bc9c816c043f84cbb670d1bb5 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save eirnym/0915511bc9c816c043f84cbb670d1bb5 to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. @powerman powerman revised this gist Aug 31, 2015. 1 changed file with 4 additions and 2 deletions.
    6 changes: 4 additions & 2 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -1,8 +1,8 @@
    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :toc-placement: preamble
    :toclevels: 1
    :showtitle:
    :Some attr: Some value

    @@ -45,11 +45,13 @@ see limitations of GitHub Gist. Here is current list:
    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toc-placement: preamble
    :toclevels: 1
    :showtitle:
    :Some attr: Some value
    toc::[]
    // Need some preamble to get TOC:
    {empty}
    ----

    ++++
  2. @powerman powerman revised this gist Aug 31, 2015. 1 changed file with 3 additions and 2 deletions.
    5 changes: 3 additions & 2 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -2,11 +2,12 @@ Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :toc-placement: auto
    :toc-placement: preamble
    :showtitle:
    :Some attr: Some value

    toc::[]
    // Need some preamble to get TOC:
    {empty}


    == GitHub limitations
  3. @powerman powerman revised this gist Aug 31, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -2,7 +2,7 @@ Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :toc-placement: manual
    :toc-placement: auto
    :showtitle:
    :Some attr: Some value

  4. @powerman powerman revised this gist Aug 31, 2015. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -2,6 +2,7 @@ Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :toc-placement: manual
    :showtitle:
    :Some attr: Some value

  5. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 2 additions and 1 deletion.
    3 changes: 2 additions & 1 deletion AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -27,7 +27,7 @@ This is copy of https://github.com/powerman/asciidoc-cheatsheet to
    see limitations of GitHub Gist. Here is current list:
    - Gist must have a file name with one of asciidoc's extensions.
    - Document title is not rendered.
    - Document title is not rendered without `:showtitle:` attribute.
    - "Table of Contents" contains extra bullets, which makes more than 1 level toc too ugly.
    - Link in "Table of Contents" doesn't work because generated links start with extra `_`.
    - No syntax highlight for `[source]`.
    @@ -44,6 +44,7 @@ Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :showtitle:
    :Some attr: Some value
    toc::[]
  6. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -2,6 +2,7 @@ Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :showtitle:
    :Some attr: Some value

    toc::[]
  7. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 14 additions and 12 deletions.
    26 changes: 14 additions & 12 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -762,22 +762,24 @@ mailto:root@localhost[email admin]
    ++++

    ....
    // Real urls are too long and don't fit
    // Use attribute to shorten urls
    :repo: https://github.com/powerman/asciidoc-cheatsheet
    :img: {repo}/raw/master/images
    First home
    image:https://github.com/.../home.png[]
    image:{img}/icons/home.png[]
    , second home
    image:https://github.com/.../home.png[Alt text]
    image:{img}/icons/home.png[Alt text]
    .
    .Block image
    image::https://github.com/.../home.png[]
    image::https://github.com/.../home.png[Alt text]
    image::{img}/icons/home.png[]
    image::{img}/icons/home.png[Alt text]
    .Thumbnail linked to full image
    image:https://github.com/.../640-screen2.gif[
    image:{img}/font/640-screen2.gif[
    "My screenshot",width=128,
    link="https://github.com/.../640-screen2.gif"]
    link="{img}/font/640-screen2.gif"]
    ....

    ++++
    @@ -791,17 +793,17 @@ link="https://github.com/.../640-screen2.gif"]
    First home
    image:{img}/icons/home.png[]
    , second home
    image:https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[Alt text]
    image:{img}/icons/home.png[Alt text]
    .

    .Block image
    image::https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[]
    image::https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[Alt text]
    image::{img}/icons/home.png[]
    image::{img}/icons/home.png[Alt text]

    .Thumbnail linked to full image
    image:https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/font/640-screen2.gif[
    image:{img}/font/640-screen2.gif[
    "My screenshot",width=128,
    link="https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/font/640-screen2.gif"]
    link="{img}/font/640-screen2.gif"]

    ++++
    </td></tr>
  8. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 5 additions and 1 deletion.
    6 changes: 5 additions & 1 deletion AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -784,8 +784,12 @@ link="https://github.com/.../640-screen2.gif"]
    </td><td class=cheatsheet-render>
    ++++

    // Use attribute to shorten urls
    :repo: https://github.com/powerman/asciidoc-cheatsheet
    :img: {repo}/raw/master/images

    First home
    image:https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[]
    image:{img}/icons/home.png[]
    , second home
    image:https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[Alt text]
    .
  9. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 2 additions and 2 deletions.
    4 changes: 2 additions & 2 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -1,5 +1,5 @@
    Asciidoc cheatsheet for GitHub2
    ===============================
    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :Some attr: Some value
  10. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 2 additions and 2 deletions.
    4 changes: 2 additions & 2 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -1,5 +1,5 @@
    Asciidoc cheatsheet for GitHub
    ==============================
    Asciidoc cheatsheet for GitHub2
    ===============================
    :toc:
    :toclevels: 1
    :Some attr: Some value
  11. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 13 additions and 3 deletions.
    16 changes: 13 additions & 3 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -15,14 +15,24 @@ for now it's main use is to show bugs, design issues, GitHub limitations
    and other differences from http://powerman.name/doc/asciidoc[how Asciidoc
    cheatsheet should really looks like].

    GitHub Wiki has own limitations, check
    https://github.com/powerman/asciidoc-cheatsheet/wiki[this cheatsheet in wiki].

    You can try these browser add-ons to fix some issues:

    - https://github.com/powerman/userjs-github-asciidoc[UserJS for GitHub: fix Asciidoc rendering]
    - https://userstyles.org/styles/113008/github-compact-markdown-asciidoc-lists[UserCSS for GitHub: compact Markdown/Asciidoc lists]

    [NOTE]
    ====
    This is copy of https://github.com/powerman/asciidoc-cheatsheet to
    see limitations of GitHub Gist. Here is current list:
    - Gist must have a file name with one of asciidoc's extensions.
    - Document title is not rendered.
    - "Table of Contents" contains extra bullets, which makes more than 1 level toc too ugly.
    - Link in "Table of Contents" doesn't work because generated links start with extra `_`.
    - No syntax highlight for `[source]`.
    - Custom anchors doesn't work.
    - Relative/absolute links works in different way.
    ====

    == Attributes

  12. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 8 additions and 6 deletions.
    14 changes: 8 additions & 6 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -752,20 +752,22 @@ mailto:root@localhost[email admin]
    ++++

    ....
    // Real urls are too long and don't fit
    First home
    image:images/icons/home.png[]
    image:https://github.com/.../home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    image:https://github.com/.../home.png[Alt text]
    .
    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]
    image::https://github.com/.../home.png[]
    image::https://github.com/.../home.png[Alt text]
    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    image:https://github.com/.../640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]
    link="https://github.com/.../640-screen2.gif"]
    ....

    ++++
  13. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 6 additions and 6 deletions.
    12 changes: 6 additions & 6 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -773,19 +773,19 @@ link="/images/font/640-screen2.gif"]
    ++++

    First home
    image:images/icons/home.png[]
    image:https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    image:https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[Alt text]
    .

    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]
    image::https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[]
    image::https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/icons/home.png[Alt text]

    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    image:https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/font/640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]
    link="https://github.com/powerman/asciidoc-cheatsheet/raw/master/images/font/640-screen2.gif"]

    ++++
    </td></tr>
  14. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 2 additions and 8 deletions.
    10 changes: 2 additions & 8 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -680,12 +680,9 @@ If you'll need to use space in url/path you should replace it with %20.
    ++++

    ....
    [[anchor1]]
    [[anchor-1]]
    Paragraph or block 1.
    anchor:anchor2[]
    Paragraph or block 2.
    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
    @@ -696,12 +693,9 @@ xref:anchor-1[First anchor].
    </td><td class=cheatsheet-render>
    ++++

    [[anchor1]]
    [[anchor-1]]
    Paragraph or block 1.

    anchor:anchor2[]
    Paragraph or block 2.

    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
  15. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 4 additions and 1 deletion.
    5 changes: 4 additions & 1 deletion AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -696,9 +696,12 @@ xref:anchor-1[First anchor].
    </td><td class=cheatsheet-render>
    ++++

    [[anchor-1]]
    [[anchor1]]
    Paragraph or block 1.

    anchor:anchor2[]
    Paragraph or block 2.

    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
  16. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 4 additions and 1 deletion.
    5 changes: 4 additions & 1 deletion AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -680,9 +680,12 @@ If you'll need to use space in url/path you should replace it with %20.
    ++++

    ....
    [[anchor-1]]
    [[anchor1]]
    Paragraph or block 1.
    anchor:anchor2[]
    Paragraph or block 2.
    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
  17. @powerman powerman revised this gist Apr 27, 2015. 2 changed files with 1436 additions and 14 deletions.
    14 changes: 0 additions & 14 deletions Asciidoc Cheatsheet
    View file
    Original file line number Diff line number Diff line change
    @@ -1,14 +0,0 @@
    This cheatsheet contains small part of Asciidoc markup which works and
    looks fine on GitHub. There is also link:full.adoc[full cheatsheet], but
    for now it's main use is to show bugs, design issues, GitHub limitations
    and other differences from http://powerman.name/doc/asciidoc[how Asciidoc
    cheatsheet should really looks like].

    GitHub Wiki has own limitations, check
    https://github.com/powerman/asciidoc-cheatsheet/wiki[this cheatsheet in wiki].

    You can try these browser add-ons to fix some issues:

    - https://github.com/powerman/userjs-github-asciidoc[UserJS for GitHub: fix Asciidoc rendering]
    - https://userstyles.org/styles/113008/github-compact-markdown-asciidoc-lists[UserCSS for GitHub: compact Markdown/Asciidoc lists]

    1,436 changes: 1,436 additions & 0 deletions AsciidocCheatsheet.adoc
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,1436 @@
    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :Some attr: Some value

    toc::[]


    == GitHub limitations

    This cheatsheet contains small part of Asciidoc markup which works and
    looks fine on GitHub. There is also link:full.adoc[full cheatsheet], but
    for now it's main use is to show bugs, design issues, GitHub limitations
    and other differences from http://powerman.name/doc/asciidoc[how Asciidoc
    cheatsheet should really looks like].

    GitHub Wiki has own limitations, check
    https://github.com/powerman/asciidoc-cheatsheet/wiki[this cheatsheet in wiki].

    You can try these browser add-ons to fix some issues:

    - https://github.com/powerman/userjs-github-asciidoc[UserJS for GitHub: fix Asciidoc rendering]
    - https://userstyles.org/styles/113008/github-compact-markdown-asciidoc-lists[UserCSS for GitHub: compact Markdown/Asciidoc lists]


    == Attributes

    ----
    // Header of this document:
    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :Some attr: Some value
    toc::[]
    ----

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Some attr's value is {someattr}.
    Escaped: \{someattr} and +++{someattr}+++.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Some attr's value is {someattr}.
    Escaped: \{someattr} and +++{someattr}+++.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Headers

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    == Level 1
    Text.
    === Level 2
    Text.
    ==== Level 3
    Text.
    ===== Level 4
    Text.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    == Level 1
    Text.

    === Level 2
    Text.

    ==== Level 3
    Text.

    ===== Level 4
    Text.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Paragraphs

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    Usual
    paragraph.
    Second paragraph.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    Usual
    paragraph.

    Second paragraph.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    Literal paragraph.
    Must be indented.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title

    Literal paragraph.
    Must be indented.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    [source,perl]
    die 'connect: '.$dbh->errstr;
    Not a code in next paragraph.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    [source,perl]
    die 'connect: '.$dbh->errstr;

    Not a code in next paragraph.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    TIP: Some tip text.
    IMPORTANT: Some important text.
    WARNING: Some warning text.
    CAUTION: Some caution text.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    TIP: Some tip text.

    IMPORTANT: Some important text.

    WARNING: Some warning text.

    CAUTION: Some caution text.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Blocks

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    ----
    *Listing* Block
    Use: code or file listings
    ----
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    ----
    *Listing* Block
    Use: code or file listings
    ----

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    [NOTE]
    ====
    *NOTE* Block
    Use: multi-paragraph notes.
    ====
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    [NOTE]
    ====
    *NOTE* Block
    Use: multi-paragraph notes.
    ====

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ////
    *Comment* block
    Use: hide comments
    ////
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ////
    *Comment* block
    Use: hide comments
    ////

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ++++
    *Passthrough* Block
    <p>
    Use: GitHub-restricted subset of HTML markup
    <table border="1">
    <tr><td>1</td><td>2</td></tr>
    </table>
    ++++
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ++++
    *Passthrough* Block
    <p>
    Use: <a href="https://github.com/jch/html-pipeline/blob/master/lib/html/pipeline/sanitization_filter.rb">GitHub-restricted subset of HTML</a> markup
    <table border="1">
    <tr><td>1</td><td>2</td></tr>
    </table>
    ++++

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    ....
    *Literal* Block
    Use: workaround when literal
    paragraph (indented) like
    1. First.
    2. Second.
    incorrectly processed as list.
    ....
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    ....
    *Literal* Block
    Use: workaround when literal
    paragraph (indented) like
    1. First.
    2. Second.
    incorrectly processed as list.
    ....

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Text

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    forced +
    line break
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    forced +
    line break

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    normal, 'italic', _italic_, *bold*.
    +mono *bold*+, `mono pass thru *bold*`
    ``double quoted'', `single quoted'.
    normal, ^super^, ~sub~.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    normal, 'italic', _italic_, *bold*.

    +mono *bold*+, `mono pass thru *bold*`

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

    normal, ^super^, ~sub~.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Chars: n__i__**b**++m++n
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Chars: n__i__**b**++m++n

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    // Comment
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    // Comment

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ''''
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ''''

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Escaped:
    \_italic_, +++_italic_+++,
    t\__e__st, +++t__e__st+++,
    \&#182;
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Escaped:
    \_italic_, +++_italic_+++,
    t\__e__st, +++t__e__st+++,
    \&#182;

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Macros: links, images

    ++++
    <table class=cheatsheet>
    ++++

    If you'll need to use space in url/path you should replace it with %20.

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [[anchor-1]]
    Paragraph or block 1.
    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
    xref:anchor-1[First anchor].
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [[anchor-1]]
    Paragraph or block 1.

    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
    xref:anchor-1[First anchor].

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    link:README.adoc[This document]
    link:/README.adoc[]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    link:README.adoc[This document]
    link:/README.adoc[]

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    http://google.com
    http://google.com[Google Search]
    mailto:root@localhost[email admin]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    http://google.com
    http://google.com[Google Search]
    mailto:root@localhost[email admin]

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    First home
    image:images/icons/home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    .
    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]
    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    First home
    image:images/icons/home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    .

    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]

    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Lists

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Ordered
    . number
    . number
    .. lower roman
    .. lower roman
    . number
    .. lower roman
    .. lower roman
    ... lower alpha
    ... lower alpha
    .... lower alpha
    .... lower alpha
    ..... lower alpha
    ..... lower alpha
    .... lower alpha
    ... lower alpha
    .. lower roman
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Ordered
    . number
    . number
    .. lower roman
    .. lower roman
    . number
    .. lower roman
    .. lower roman
    ... lower alpha
    ... lower alpha
    .... lower alpha
    .... lower alpha
    ..... lower alpha
    ..... lower alpha
    .... lower alpha
    ... lower alpha
    .. lower roman
    . number

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Ordered 2
    a. lower alpha
    b. lower alpha
    .. lower roman
    .. lower roman
    . lower alpha
    . lower alpha
    1. lower alpha
    2. lower alpha
    3. lower alpha
    4. lower alpha
    . lower alpha
    .. lower roman
    c. lower alpha
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Ordered 2
    a. lower alpha
    b. lower alpha
    .. lower roman
    .. lower roman
    . lower alpha
    . lower alpha
    1. lower alpha
    2. lower alpha
    3. lower alpha
    4. lower alpha
    . lower alpha
    .. lower roman
    c. lower alpha

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .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
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Labeled 2
    Term 1;;
    Definition 1
    Term 1.1::
    Definition 1.1
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Labeled 2
    Term 1;;
    Definition 1
    Term 1.1::
    Definition 1.1

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [horizontal]
    .Labeled horizontal
    Term 1:: Definition 1
    Term 2:: Definition 2
    Term 3::
    Definition 3
    Term 4:: Definition 4
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [horizontal]
    .Labeled horizontal
    Term 1:: Definition 1
    Term 2:: Definition 2

    Term 3::
    Definition 3

    Term 4:: Definition 4

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [qanda]
    .Q&A
    Question 1::
    Answer 1
    Question 2:: Answer 2
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [qanda]
    .Q&A
    Question 1::
    Answer 1
    Question 2:: Answer 2

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Break two lists
    . number
    . number
    Independent paragraph break list.
    . number
    .Header break list too
    . number
    --
    . List block define list boundary too
    . number
    . number
    --
    . number
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Break two lists
    . number
    . number

    Independent paragraph break list.

    . number

    .Header break list too
    . number

    --
    . List block define list boundary too
    . number
    . number
    --

    . number
    . number

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Continuation
    - bullet
    continuation
    . number
    continuation
    * bullet

    literal continuation

    .. letter
    +
    Non-literal continuation.
    +
    ----
    any block can be
    included in list
    ----
    +
    Last continuation.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .List block allow sublist inclusion
    - bullet
    * bullet
    +
    --
    - bullet
    * bullet
    --
    * bullet
    - bullet
    . number
    .. lower alpha
    +
    --
    . number
    .. lower alpha
    --
    .. lower alpha
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .List block allow sublist inclusion
    - bullet
    * bullet
    +
    --
    - bullet
    * bullet
    --
    * bullet
    - bullet
    . number
    .. lower alpha
    +
    --
    . number
    .. lower alpha
    --
    .. lower alpha
    . number

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Tables

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .An example table
    [options="header,footer"]
    |=======================
    |Col 1|Col 2 |Col 3
    |1 |Item 1 |a
    |2 |Item 2 |b
    |3 |Item 3 |c
    |6 |Three items|d
    |=======================
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .An example table
    [options="header,footer"]
    |=======================
    |Col 1|Col 2 |Col 3
    |1 |Item 1 |a
    |2 |Item 2 |b
    |3 |Item 3 |c
    |6 |Three items|d
    |=======================

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .CSV data
    [format="csv",cols="4"]
    |======
    1,2,3,4
    a,b,c,d
    A,B,C,D
    |======
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .CSV data
    [format="csv",cols="4"]
    |======
    1,2,3,4
    a,b,c,d
    A,B,C,D
    |======

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [format="csv"]
    [options="header",cols=",,s,,m"]
    |===========================
    ID,FName,LName,Address,Phone
    1,Vasya,Pupkin,London,+123
    2,X,Y,"A,B",45678
    |===========================
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    // Table column align doesn't work.
    [format="csv"]
    [options="header",cols=",,s,,m"]
    |===========================
    ID,FName,LName,Address,Phone
    1,Vasya,Pupkin,London,+123
    2,X,Y,"A,B",45678
    |===========================

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Multiline cells, row/col span
    |====
    |Date |Duration |Avg HR |Notes

    |22-Aug-08 .2+^.^|10:24 | 157 |
    Worked out MSHR (max sustainable
    heart rate) by going hard
    for this interval.

    |22-Aug-08 | 152 |
    Back-to-back with previous interval.

    |24-Aug-08 3+^|none

    |====

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++

  18. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 0 additions and 3 deletions.
    3 changes: 0 additions & 3 deletions Asciidoc Cheatsheet
    View file
    Original file line number Diff line number Diff line change
    @@ -1,6 +1,3 @@

    == GitHub limitations

    This cheatsheet contains small part of Asciidoc markup which works and
    looks fine on GitHub. There is also link:full.adoc[full cheatsheet], but
    for now it's main use is to show bugs, design issues, GitHub limitations
  19. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 0 additions and 2 deletions.
    2 changes: 0 additions & 2 deletions Asciidoc Cheatsheet
    View file
    Original file line number Diff line number Diff line change
    @@ -1,5 +1,3 @@
    Asciidoc cheatsheet for GitHub
    ==============================

    == GitHub limitations

  20. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 0 additions and 6 deletions.
    6 changes: 0 additions & 6 deletions Asciidoc Cheatsheet
    View file
    Original file line number Diff line number Diff line change
    @@ -1,11 +1,5 @@
    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :Some attr: Some value

    toc::[]


    == GitHub limitations

  21. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 1 addition and 1412 deletions.
    1,413 changes: 1 addition & 1,412 deletions Asciidoc Cheatsheet
    View file
    Original file line number Diff line number Diff line change
    @@ -4,7 +4,7 @@ Asciidoc cheatsheet for GitHub
    :toclevels: 1
    :Some attr: Some value

    // toc::[]
    toc::[]


    == GitHub limitations
    @@ -23,1414 +23,3 @@ You can try these browser add-ons to fix some issues:
    - https://github.com/powerman/userjs-github-asciidoc[UserJS for GitHub: fix Asciidoc rendering]
    - https://userstyles.org/styles/113008/github-compact-markdown-asciidoc-lists[UserCSS for GitHub: compact Markdown/Asciidoc lists]


    == Attributes

    ----
    // Header of this document:

    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :Some attr: Some value

    toc::[]
    ----

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Some attr's value is {someattr}.
    Escaped: \{someattr} and +++{someattr}+++.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Some attr's value is {someattr}.
    Escaped: \{someattr} and +++{someattr}+++.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Headers

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    == Level 1
    Text.

    === Level 2
    Text.

    ==== Level 3
    Text.

    ===== Level 4
    Text.

    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    == Level 1
    Text.

    === Level 2
    Text.

    ==== Level 3
    Text.

    ===== Level 4
    Text.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Paragraphs

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    Usual
    paragraph.

    Second paragraph.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    Usual
    paragraph.

    Second paragraph.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title

    Literal paragraph.
    Must be indented.

    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title

    Literal paragraph.
    Must be indented.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    [source,perl]
    die 'connect: '.$dbh->errstr;

    Not a code in next paragraph.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    [source,perl]
    die 'connect: '.$dbh->errstr;

    Not a code in next paragraph.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    TIP: Some tip text.

    IMPORTANT: Some important text.

    WARNING: Some warning text.

    CAUTION: Some caution text.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    TIP: Some tip text.

    IMPORTANT: Some important text.

    WARNING: Some warning text.

    CAUTION: Some caution text.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Blocks

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    ----
    *Listing* Block

    Use: code or file listings
    ----
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    ----
    *Listing* Block

    Use: code or file listings
    ----

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    [source,perl]
    ----
    # *Source* block
    # Use: highlight code listings
    use DBI;

    my $dbh = DBI->connect('...',$u,$p)
    or die "connect: $dbh->errstr";
    ----
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    [source,perl]
    ----
    # *Source* block
    # Use: highlight code listings
    use DBI;

    my $dbh = DBI->connect('...',$u,$p)
    or die "connect: $dbh->errstr";
    ----

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    Use: multi-paragraph notes.
    ====

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    Use: cite somebody
    ____
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    Use: cite somebody
    ____

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ////
    *Comment* block

    Use: hide comments
    ////
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ////
    *Comment* block

    Use: hide comments
    ////

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ++++
    *Passthrough* Block
    <p>
    Use: GitHub-restricted subset of HTML markup
    <table border="1">
    <tr><td>1</td><td>2</td></tr>
    </table>
    ++++
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ++++
    *Passthrough* Block
    <p>
    Use: <a href="https://github.com/jch/html-pipeline/blob/master/lib/html/pipeline/sanitization_filter.rb">GitHub-restricted subset of HTML</a> markup
    <table border="1">
    <tr><td>1</td><td>2</td></tr>
    </table>
    ++++

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    ....
    *Literal* Block

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    ....
    *Literal* Block

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

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Text

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    forced +
    line break
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    forced +
    line break

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    normal, 'italic', _italic_, *bold*.

    +mono *bold*+, `mono pass thru *bold*`

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

    normal, ^super^, ~sub~.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    normal, 'italic', _italic_, *bold*.

    +mono *bold*+, `mono pass thru *bold*`

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

    normal, ^super^, ~sub~.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Chars: n__i__**b**++m++n
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Chars: n__i__**b**++m++n

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    // Comment
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    // Comment

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ''''
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ''''

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Escaped:
    \_italic_, +++_italic_+++,
    t\__e__st, +++t__e__st+++,
    \&#182;
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Escaped:
    \_italic_, +++_italic_+++,
    t\__e__st, +++t__e__st+++,
    \&#182;

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Macros: links, images

    ++++
    <table class=cheatsheet>
    ++++

    If you'll need to use space in url/path you should replace it with %20.

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [[anchor-1]]
    Paragraph or block 1.

    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
    xref:anchor-1[First anchor].
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [[anchor-1]]
    Paragraph or block 1.

    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
    xref:anchor-1[First anchor].

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    link:README.adoc[This document]
    link:/README.adoc[]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    link:README.adoc[This document]
    link:/README.adoc[]

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    http://google.com
    http://google.com[Google Search]
    mailto:root@localhost[email admin]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    http://google.com
    http://google.com[Google Search]
    mailto:root@localhost[email admin]

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    First home
    image:images/icons/home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    .

    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]

    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    First home
    image:images/icons/home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    .

    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]

    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Lists

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Ordered
    . number
    . number
    .. lower roman
    .. lower roman
    . number
    .. lower roman
    .. lower roman
    ... lower alpha
    ... lower alpha
    .... lower alpha
    .... lower alpha
    ..... lower alpha
    ..... lower alpha
    .... lower alpha
    ... lower alpha
    .. lower roman
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Ordered
    . number
    . number
    .. lower roman
    .. lower roman
    . number
    .. lower roman
    .. lower roman
    ... lower alpha
    ... lower alpha
    .... lower alpha
    .... lower alpha
    ..... lower alpha
    ..... lower alpha
    .... lower alpha
    ... lower alpha
    .. lower roman
    . number

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Ordered 2
    a. lower alpha
    b. lower alpha
    .. lower roman
    .. lower roman
    . lower alpha
    . lower alpha
    1. lower alpha
    2. lower alpha
    3. lower alpha
    4. lower alpha
    . lower alpha
    .. lower roman
    c. lower alpha
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Ordered 2
    a. lower alpha
    b. lower alpha
    .. lower roman
    .. lower roman
    . lower alpha
    . lower alpha
    1. lower alpha
    2. lower alpha
    3. lower alpha
    4. lower alpha
    . lower alpha
    .. lower roman
    c. lower alpha

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .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
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Labeled 2
    Term 1;;
    Definition 1
    Term 1.1::
    Definition 1.1
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Labeled 2
    Term 1;;
    Definition 1
    Term 1.1::
    Definition 1.1

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [horizontal]
    .Labeled horizontal
    Term 1:: Definition 1
    Term 2:: Definition 2

    Term 3::
    Definition 3

    Term 4:: Definition 4
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [horizontal]
    .Labeled horizontal
    Term 1:: Definition 1
    Term 2:: Definition 2

    Term 3::
    Definition 3

    Term 4:: Definition 4

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [qanda]
    .Q&A
    Question 1::
    Answer 1
    Question 2:: Answer 2
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [qanda]
    .Q&A
    Question 1::
    Answer 1
    Question 2:: Answer 2

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Break two lists
    . number
    . number

    Independent paragraph break list.

    . number

    .Header break list too
    . number

    --
    . List block define list boundary too
    . number
    . number
    --

    . number
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Break two lists
    . number
    . number

    Independent paragraph break list.

    . number

    .Header break list too
    . number

    --
    . List block define list boundary too
    . number
    . number
    --

    . number
    . number

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Continuation
    - bullet
    continuation
    . number
    continuation
    * bullet

    literal continuation

    .. letter
    +
    Non-literal continuation.
    +
    ----
    any block can be

    included in list
    ----
    +
    Last continuation.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Continuation
    - bullet
    continuation
    . number
    continuation
    * bullet

    literal continuation

    .. letter
    +
    Non-literal continuation.
    +
    ----
    any block can be

    included in list
    ----
    +
    Last continuation.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .List block allow sublist inclusion
    - bullet
    * bullet
    +
    --
    - bullet
    * bullet
    --
    * bullet
    - bullet
    . number
    .. lower alpha
    +
    --
    . number
    .. lower alpha
    --
    .. lower alpha
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .List block allow sublist inclusion
    - bullet
    * bullet
    +
    --
    - bullet
    * bullet
    --
    * bullet
    - bullet
    . number
    .. lower alpha
    +
    --
    . number
    .. lower alpha
    --
    .. lower alpha
    . number

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Tables

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .An example table
    [options="header,footer"]
    |=======================
    |Col 1|Col 2 |Col 3
    |1 |Item 1 |a
    |2 |Item 2 |b
    |3 |Item 3 |c
    |6 |Three items|d
    |=======================
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .An example table
    [options="header,footer"]
    |=======================
    |Col 1|Col 2 |Col 3
    |1 |Item 1 |a
    |2 |Item 2 |b
    |3 |Item 3 |c
    |6 |Three items|d
    |=======================

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .CSV data
    [format="csv",cols="4"]
    |======
    1,2,3,4
    a,b,c,d
    A,B,C,D
    |======
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .CSV data
    [format="csv",cols="4"]
    |======
    1,2,3,4
    a,b,c,d
    A,B,C,D
    |======

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [format="csv"]
    [options="header",cols=",,s,,m"]
    |===========================
    ID,FName,LName,Address,Phone
    1,Vasya,Pupkin,London,+123
    2,X,Y,"A,B",45678
    |===========================
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    // Table column align doesn't work.
    [format="csv"]
    [options="header",cols=",,s,,m"]
    |===========================
    ID,FName,LName,Address,Phone
    1,Vasya,Pupkin,London,+123
    2,X,Y,"A,B",45678
    |===========================

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Multiline cells, row/col span
    |====
    |Date |Duration |Avg HR |Notes

    |22-Aug-08 .2+^.^|10:24 | 157 |
    Worked out MSHR (max sustainable
    heart rate) by going hard
    for this interval.

    |22-Aug-08 | 152 |
    Back-to-back with previous interval.

    |24-Aug-08 3+^|none

    |====
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Multiline cells, row/col span
    |====
    |Date |Duration |Avg HR |Notes

    |22-Aug-08 .2+^.^|10:24 | 157 |
    Worked out MSHR (max sustainable
    heart rate) by going hard
    for this interval.

    |22-Aug-08 | 152 |
    Back-to-back with previous interval.

    |24-Aug-08 3+^|none

    |====

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++

  22. @powerman powerman revised this gist Apr 27, 2015. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Asciidoc Cheatsheet
    View file
    Original file line number Diff line number Diff line change
    @@ -4,7 +4,7 @@ Asciidoc cheatsheet for GitHub
    :toclevels: 1
    :Some attr: Some value

    toc::[]
    // toc::[]


    == GitHub limitations
  23. @powerman powerman created this gist Apr 27, 2015.
    1,436 changes: 1,436 additions & 0 deletions Asciidoc Cheatsheet
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,1436 @@
    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :Some attr: Some value

    toc::[]


    == GitHub limitations

    This cheatsheet contains small part of Asciidoc markup which works and
    looks fine on GitHub. There is also link:full.adoc[full cheatsheet], but
    for now it's main use is to show bugs, design issues, GitHub limitations
    and other differences from http://powerman.name/doc/asciidoc[how Asciidoc
    cheatsheet should really looks like].

    GitHub Wiki has own limitations, check
    https://github.com/powerman/asciidoc-cheatsheet/wiki[this cheatsheet in wiki].

    You can try these browser add-ons to fix some issues:

    - https://github.com/powerman/userjs-github-asciidoc[UserJS for GitHub: fix Asciidoc rendering]
    - https://userstyles.org/styles/113008/github-compact-markdown-asciidoc-lists[UserCSS for GitHub: compact Markdown/Asciidoc lists]


    == Attributes

    ----
    // Header of this document:

    Asciidoc cheatsheet for GitHub
    ==============================
    :toc:
    :toclevels: 1
    :Some attr: Some value

    toc::[]
    ----

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Some attr's value is {someattr}.
    Escaped: \{someattr} and +++{someattr}+++.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Some attr's value is {someattr}.
    Escaped: \{someattr} and +++{someattr}+++.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Headers

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    == Level 1
    Text.

    === Level 2
    Text.

    ==== Level 3
    Text.

    ===== Level 4
    Text.

    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    == Level 1
    Text.

    === Level 2
    Text.

    ==== Level 3
    Text.

    ===== Level 4
    Text.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Paragraphs

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    Usual
    paragraph.

    Second paragraph.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    Usual
    paragraph.

    Second paragraph.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title

    Literal paragraph.
    Must be indented.

    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title

    Literal paragraph.
    Must be indented.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    [source,perl]
    die 'connect: '.$dbh->errstr;

    Not a code in next paragraph.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    [source,perl]
    die 'connect: '.$dbh->errstr;

    Not a code in next paragraph.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    TIP: Some tip text.

    IMPORTANT: Some important text.

    WARNING: Some warning text.

    CAUTION: Some caution text.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    TIP: Some tip text.

    IMPORTANT: Some important text.

    WARNING: Some warning text.

    CAUTION: Some caution text.

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Blocks

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    ----
    *Listing* Block

    Use: code or file listings
    ----
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    ----
    *Listing* Block

    Use: code or file listings
    ----

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    [source,perl]
    ----
    # *Source* block
    # Use: highlight code listings
    use DBI;

    my $dbh = DBI->connect('...',$u,$p)
    or die "connect: $dbh->errstr";
    ----
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    [source,perl]
    ----
    # *Source* block
    # Use: highlight code listings
    use DBI;

    my $dbh = DBI->connect('...',$u,$p)
    or die "connect: $dbh->errstr";
    ----

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    Use: multi-paragraph notes.
    ====

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    Use: cite somebody
    ____
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    Use: cite somebody
    ____

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ////
    *Comment* block

    Use: hide comments
    ////
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ////
    *Comment* block

    Use: hide comments
    ////

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ++++
    *Passthrough* Block
    <p>
    Use: GitHub-restricted subset of HTML markup
    <table border="1">
    <tr><td>1</td><td>2</td></tr>
    </table>
    ++++
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ++++
    *Passthrough* Block
    <p>
    Use: <a href="https://github.com/jch/html-pipeline/blob/master/lib/html/pipeline/sanitization_filter.rb">GitHub-restricted subset of HTML</a> markup
    <table border="1">
    <tr><td>1</td><td>2</td></tr>
    </table>
    ++++

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Optional Title
    ....
    *Literal* Block

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Optional Title
    ....
    *Literal* Block

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

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Text

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    forced +
    line break
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    forced +
    line break

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    normal, 'italic', _italic_, *bold*.

    +mono *bold*+, `mono pass thru *bold*`

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

    normal, ^super^, ~sub~.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    normal, 'italic', _italic_, *bold*.

    +mono *bold*+, `mono pass thru *bold*`

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

    normal, ^super^, ~sub~.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Chars: n__i__**b**++m++n
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Chars: n__i__**b**++m++n

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    // Comment
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    // Comment

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    ''''
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    ''''

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    Escaped:
    \_italic_, +++_italic_+++,
    t\__e__st, +++t__e__st+++,
    \&#182;
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    Escaped:
    \_italic_, +++_italic_+++,
    t\__e__st, +++t__e__st+++,
    \&#182;

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Macros: links, images

    ++++
    <table class=cheatsheet>
    ++++

    If you'll need to use space in url/path you should replace it with %20.

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [[anchor-1]]
    Paragraph or block 1.

    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
    xref:anchor-1[First anchor].
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [[anchor-1]]
    Paragraph or block 1.

    <<anchor-1>>,
    <<anchor-1,First anchor>>,
    xref:anchor-1[],
    xref:anchor-1[First anchor].

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    link:README.adoc[This document]
    link:/README.adoc[]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    link:README.adoc[This document]
    link:/README.adoc[]

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    http://google.com
    http://google.com[Google Search]
    mailto:root@localhost[email admin]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    http://google.com
    http://google.com[Google Search]
    mailto:root@localhost[email admin]

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    First home
    image:images/icons/home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    .

    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]

    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    First home
    image:images/icons/home.png[]
    , second home
    image:images/icons/home.png[Alt text]
    .

    .Block image
    image::images/icons/home.png[]
    image::images/icons/home.png[Alt text]

    .Thumbnail linked to full image
    image:/images/font/640-screen2.gif[
    "My screenshot",width=128,
    link="/images/font/640-screen2.gif"]

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Lists

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

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

    ++++
    </td><td class=cheatsheet-render>
    ++++

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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Ordered
    . number
    . number
    .. lower roman
    .. lower roman
    . number
    .. lower roman
    .. lower roman
    ... lower alpha
    ... lower alpha
    .... lower alpha
    .... lower alpha
    ..... lower alpha
    ..... lower alpha
    .... lower alpha
    ... lower alpha
    .. lower roman
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Ordered
    . number
    . number
    .. lower roman
    .. lower roman
    . number
    .. lower roman
    .. lower roman
    ... lower alpha
    ... lower alpha
    .... lower alpha
    .... lower alpha
    ..... lower alpha
    ..... lower alpha
    .... lower alpha
    ... lower alpha
    .. lower roman
    . number

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Ordered 2
    a. lower alpha
    b. lower alpha
    .. lower roman
    .. lower roman
    . lower alpha
    . lower alpha
    1. lower alpha
    2. lower alpha
    3. lower alpha
    4. lower alpha
    . lower alpha
    .. lower roman
    c. lower alpha
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Ordered 2
    a. lower alpha
    b. lower alpha
    .. lower roman
    .. lower roman
    . lower alpha
    . lower alpha
    1. lower alpha
    2. lower alpha
    3. lower alpha
    4. lower alpha
    . lower alpha
    .. lower roman
    c. lower alpha

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .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
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .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

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Labeled 2
    Term 1;;
    Definition 1
    Term 1.1::
    Definition 1.1
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Labeled 2
    Term 1;;
    Definition 1
    Term 1.1::
    Definition 1.1

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [horizontal]
    .Labeled horizontal
    Term 1:: Definition 1
    Term 2:: Definition 2

    Term 3::
    Definition 3

    Term 4:: Definition 4
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [horizontal]
    .Labeled horizontal
    Term 1:: Definition 1
    Term 2:: Definition 2

    Term 3::
    Definition 3

    Term 4:: Definition 4

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [qanda]
    .Q&A
    Question 1::
    Answer 1
    Question 2:: Answer 2
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    [qanda]
    .Q&A
    Question 1::
    Answer 1
    Question 2:: Answer 2

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Break two lists
    . number
    . number

    Independent paragraph break list.

    . number

    .Header break list too
    . number

    --
    . List block define list boundary too
    . number
    . number
    --

    . number
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Break two lists
    . number
    . number

    Independent paragraph break list.

    . number

    .Header break list too
    . number

    --
    . List block define list boundary too
    . number
    . number
    --

    . number
    . number

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Continuation
    - bullet
    continuation
    . number
    continuation
    * bullet

    literal continuation

    .. letter
    +
    Non-literal continuation.
    +
    ----
    any block can be

    included in list
    ----
    +
    Last continuation.
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Continuation
    - bullet
    continuation
    . number
    continuation
    * bullet

    literal continuation

    .. letter
    +
    Non-literal continuation.
    +
    ----
    any block can be

    included in list
    ----
    +
    Last continuation.

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .List block allow sublist inclusion
    - bullet
    * bullet
    +
    --
    - bullet
    * bullet
    --
    * bullet
    - bullet
    . number
    .. lower alpha
    +
    --
    . number
    .. lower alpha
    --
    .. lower alpha
    . number
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .List block allow sublist inclusion
    - bullet
    * bullet
    +
    --
    - bullet
    * bullet
    --
    * bullet
    - bullet
    . number
    .. lower alpha
    +
    --
    . number
    .. lower alpha
    --
    .. lower alpha
    . number

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++


    == Tables

    ++++
    <table class=cheatsheet>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .An example table
    [options="header,footer"]
    |=======================
    |Col 1|Col 2 |Col 3
    |1 |Item 1 |a
    |2 |Item 2 |b
    |3 |Item 3 |c
    |6 |Three items|d
    |=======================
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .An example table
    [options="header,footer"]
    |=======================
    |Col 1|Col 2 |Col 3
    |1 |Item 1 |a
    |2 |Item 2 |b
    |3 |Item 3 |c
    |6 |Three items|d
    |=======================

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .CSV data
    [format="csv",cols="4"]
    |======
    1,2,3,4
    a,b,c,d
    A,B,C,D
    |======
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .CSV data
    [format="csv",cols="4"]
    |======
    1,2,3,4
    a,b,c,d
    A,B,C,D
    |======

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    [format="csv"]
    [options="header",cols=",,s,,m"]
    |===========================
    ID,FName,LName,Address,Phone
    1,Vasya,Pupkin,London,+123
    2,X,Y,"A,B",45678
    |===========================
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    // Table column align doesn't work.
    [format="csv"]
    [options="header",cols=",,s,,m"]
    |===========================
    ID,FName,LName,Address,Phone
    1,Vasya,Pupkin,London,+123
    2,X,Y,"A,B",45678
    |===========================

    ++++
    </td></tr><tr><td></td><td></td></tr>
    ++++

    ++++
    <tr><td class=cheatsheet-source>
    ++++

    ....
    .Multiline cells, row/col span
    |====
    |Date |Duration |Avg HR |Notes

    |22-Aug-08 .2+^.^|10:24 | 157 |
    Worked out MSHR (max sustainable
    heart rate) by going hard
    for this interval.

    |22-Aug-08 | 152 |
    Back-to-back with previous interval.

    |24-Aug-08 3+^|none

    |====
    ....

    ++++
    </td><td class=cheatsheet-render>
    ++++

    .Multiline cells, row/col span
    |====
    |Date |Duration |Avg HR |Notes

    |22-Aug-08 .2+^.^|10:24 | 157 |
    Worked out MSHR (max sustainable
    heart rate) by going hard
    for this interval.

    |22-Aug-08 | 152 |
    Back-to-back with previous interval.

    |24-Aug-08 3+^|none

    |====

    ++++
    </td></tr>
    ++++

    ++++
    </table>
    ++++