Simply type and it will be generated as a paragraph.
No special markup or attributes need to be used.

:attribute_name: attribute value
.Reference an Document Attribute
`\{attribute_name}` is {attribute_name}.

.Escape an Attribute Reference
:console_domain: console.dev
[horizontal]
Normal::
  https://{console_domain}/tools
Backslash (`\`)::
  https://\{console_domain}/tools
Passthrough (`+` or `\pass:[]`)::
  +https://{console_domain}/tools+

.Thematic breaks
--
'''
--

.Markdown-style thematic breaks
--
---

- - -

***

* * *
--

* *Bold* (type: strong) (`*`)
* _Italic_ (type: emphasis) (`_`)
* `Monospace` (type: monospaced) (```)
* #Highlight# (type: mark) (`#`)
* [.line-through]#Styled phrase# (type: unquoted) (`[.<ROLE>]#`)
* ^Subscript^ (type: subscript) (`^`)
* ~Superscript~ (type: superscript) (`~`)
* Curved quotation marks
** '`Single`' (type: single) (`'``<WORD>``'`)
** "`Double`" (type: double) (`"`<WORD>`"`)
* Apostrophes sing's (type: single) (`'`)

.Unconstrained formatting pair
If the text does not begin or end with a space character,
use an unconstrained text pair consisting of
a double start mark and a double end mark around the text to be styled. +
##J##apan__ese__(**日本**``語``)

.Mixed Formatting
* *bold _italic_ `mono` #Highlight# [.red]#Red# H~2~o 2^10^ '`Single`' "`Double`"*
* **bold _italic ``mono #Highlight [.red]##Red '`Single`' "`Double`"###``_**
* `**bold _italic mono #Highlight [.red]##Red '`Single`' "`Double`"###**_`

[horizontal]
Eve:: 🐑
Raw:: 🐏
Japanese Castle:: 🏯
Mount Fuji:: 🗻
Shinto Shrine:: ⛩

.Unordered
* Level 1
** Level 2
*** Level 3
**** Level 4
***** Level 5
****** Level 6
******* Level 7
******** Level 8
********* Level 9
********** Level 10
* Level 1

.Ordered
. Level 1
.. Level 2
... Level 3
.... Level 4
..... Level 5
...... Level 6
....... Level 7
........ Level 8
......... Level 9
.......... Level 10
. Level 1
.. Level 2
... Level 3
... Level 3
.. Level 2
... Level 3

.Mixed List
* Unordered Level 1
** Unordered Level 2
. Ordered Level 3
.. Ordered Level 4
*** Unordered Level 5
... Ordered Level 6
.... Ordered Level 7
..... Ordered Level 8
**** Unordered Level 9
...... Ordered Level 10
...... Ordered Level 10
...... Ordered Level 10
..... Ordered Level 8
..... Ordered Level 8
..... Ordered Level 8
.... Ordered Level 7
.... Ordered Level 7
.... Ordered Level 7
... Ordered Level 6
... Ordered Level 6
.. Ordered Level 4
.. Ordered Level 4
. Ordered Level 3
.. Ordered Level 4
.. Ordered Level 4
. Ordered Level 3
.. Ordered Level 4
** Unordered Level 2
. Ordered Level 3
. Ordered Level 3
* Unordered Level 1
. Ordered Level 2

Word 1:: Description 1
Word 2:: Description 2
Word 3:: Description 3

.Nest
Level 1:: Level 1 Description
Level 2::: Level 2 Description
Level 3:::: Level 3 Description
Level 4;; Level 4 Description
Level 5::::: Level 5 Description
Level 6:::::: Level 6 Description

.Mixed
Level 1:: Level 1 Description 1
* Level 2 Unordered List Item 1
. Level 3 ordered List Item 1
. Level 3 ordered List Item 2
Level 4::: Level 4 Description 1
Level 4::: Level 4 Description 2
* Level 2 Unordered List Item 2
Level 3::: Level 3 Description 1
Level 1:: Level 1 Description 2
* Level 2 Unordered List Item 1
** Level 3 Unordered List Item 1
*** Level 4 Unordered List Item 1
*** Level 4 Unordered List Item 2
. Level 5 ordered List Item 1
. Level 5 ordered List Item 2
.. Level 6 ordered List Item 1
.. Level 6 ordered List Item 2
** Level 3 Unordered List Item 2
. Level 4 ordered List Item 1
. Level 4 ordered List Item 2
Level 5::: Level 5 Description 1
.. Level 6 ordered List Item 1
.. Level 6 ordered List Item 2
* Level 2 Unordered List Item 2
. Level 3 ordered List Item 1

.Autolink
[horizontal]
https:: {empty}
* https://asciidoctor.org
* https://asciidoctor.org/#sponsors
mali:: test@example.com
ftp:: ftp://localhost/index.html
irc:: irc://localhost
file:: file://index.html

.URL Macro
* In "https://asciidoctor.org[]" with URL macro (`<URL>[]`), autolink is enabled +
  In "https://asciidoctor.org", autolink is disabled
* https://asciidoctor.org[Custom link text]
* https://asciidoctor.org[
  "window=_blank (shorthand `<URL>[^\]`)",
  window=_blank]

.Link Macro
* link:https://asciidoctor.org[]
* link:./index.html[]
* link:./index.html#sections[]
* link:file:./index.html[]
* link:./index.html[Custom link text] +
  Macro attributes such as `window=_blank` are the same as URL macro.

.Double Angled Brackets(`\<<ANCHOR>>`)
[horizontal]
Minimum:: <<_sections>>
Custom Link Text:: <<_sections, Custom link text>>
Natural Cross Reference:: <<Sections>>

.xref macro(`xref:<ANCHOR>[]`)
[horizontal]
Minimum:: xref:_sections[]
Custom Link Text:: xref:_sections[Custom link text]
Natural Cross Reference:: xref:Sections[]
Inter Document Cross References:: xref:link_to_file.adoc[]

.Syntax
Footnote syntax is `\footnote:[footnote text]`.footnote:[Footnote syntax test]

.Reuse a footnote
. Set a IDfootnote:reuse_footnote[Reuse footnote test]
. How to reuse footnote is `footnote:<ID>[]`.footnote:reuse_footnote[]

.Blank
* Blank spaces are not deleted
** There is not a space between footnote macrofootnote:blank_test[There is a space between footnote macro]
** There is a space between footnote macro footnote:blank_test[]
* `apple\{empty}footnote:[]` is same as `applefootnote:[]`{empty}footnote:[Use empty attribute]

.Text Formatting
* Bold{empty}footnote:[*Bold*]
* Italic{empty}footnote:[*Italic*]
* Monospace{empty}footnote:[`Monospace`]
* Highlight{empty}footnote:[#Highlight#]
* Styled phrase{empty}footnote:[[.line-through]#Styled phrase#]
* Subscript{empty}footnote:[^Subscript^]
* Superscript{empty}footnote:[~Superscript~]
* Curved quotation marks
** Single{empty}footnote:['`Single`']
** Double{empty}footnote:["`Double`"]

.Make it easy to read
:fn_attribute_test: footnote:[use attribute]
:fn_attribute_test_for_text_formatting: pass:q[footnote:[*bold* _italic_ #highlight#]]
* Use document attributes to make footnotes easier to read{fn_attribute_test}
* If use text formatting to footnote text, use `pass` macro{fn_attribute_test_for_text_formatting}

.Block (two colons `::`)
image::block_image.webp[]

.Inline (one colon `:`)
For inline images, one colon. image:inline_image.webp[]

:example_image_content_id: 197160
:example_image_url: {pixabay_url}/photos/lawn-green-meadow-pasture-animal-{example_image_content_id}/
.Link (Let's click on the image)
image:example.webp[
link={example_image_url},
window=_blank]

.Alt Text
[horizontal]
Position Attribute:: image:alt_text.webp[Position Alt Text]
Named Attribute:: image:alt_text.webp[alt=Attribute Alt Text]

.Default
audio::sheep_bleating.mp3[]

.Start Stop
audio::sheep_bleating.mp3[start=10, end=15]

.Loop
audio::baby_lamb_calling_his_mother.mp3[options='loop']

.Local
video::example.mp4[]

.URL
video::https://storage.googleapis.com/things-roomsxyz-assets/home-page/rooms.webm[]

.Youtube Embedded
video::9NG7cFc-ddQ[youtube]

.Change Size
video::example.mp4[800, 450]

.Start Stop
video::example.mp4[start=20, end=25]

.Change Thumbnail
video::example.mp4[thumbnail.webp]

:icons: font

.Default
icon:soundcloud[]

:fontawesome_icon_url: {fontawesome_v4_url}/icon/font-awesome
.Link (Let's Click on Icon)
icon:font-awesome[
link={fontawesome_icon_url},
window=_blank]

.Color
[horizontal]
Icon:: icon:bandcamp[role="aqua"]
Background:: icon:bandcamp[role="aqua-background"]

:experimental:

.Alphabet
* kbd:[a]
* kbd:[h]
* kbd:[H]

.Number
* kbd:[0]
* kbd:[8]
* kbd:[1]

.Sign
* kbd:[_]
* kbd:[+]
* kbd:[[]
* kbd:[\]]
* kbd:[\ ]

.Modifier Key
[horizontal]
SHIFT::
  * kbd:[SHIFT+h]
  * kbd:[SHIFT+H]
CTRL:: kbd:[CTRL+h]
ALT:: kbd:[ALT+h]
Win:: kbd:[Win+h]
Cmd:: kbd:[Cmd+h]
Super:: kbd:[Super+h]
Hyper:: kbd:[Hyper+h]
Meta:: kbd:[Meta+h]
Two Modifier::
  * kbd:[CTRL+SHIFT+h]
  * kbd:[CTRL+ALT+h]
  * kbd:[CTRL+Win++]
  * kbd:[CTRL,SHIFT,,]
  * kbd:[CTRL,ALT,,]

.Function
* kbd:[F1]
* kbd:[F10]
* kbd:[F15]

.Arrow
[horizontal]
kbd:[i] > kbd:[\->] > kbd:[ESC]:: kbd:[i > \-> > ESC]
kbd:[i] -> kbd:[\->] -> kbd:[ESC]:: kbd:[i -> \-> -> ESC]
kbd:[i] => kbd:[\=>] => kbd:[ESC]:: kbd:[i => \=> => ESC]

.Space
* kbd:[h j k l]

:experimental:

.Button
* btn:[OK]
* btn:[Cancel]
* btn:[Open]

.Menu
* menu:Home[]
* menu:Home[Open File]
* menu:Home[File > Save]
* menu:Emoji[🐑 > 🐏]
* "Shorthand > 🐑 > 🐏"

:!icons:


NOTE: NOTE

TIP: TIP

IMPORTANT: IMPORTANT

CAUTION: CAUTION

WARNING: WARNING

.Admonition Block
[NOTE]
====
Delimit by four equal signs (`=`).

.List
* Item 1

.Example
======
Example Block
======
====

.sidebar attribute
[sidebar]
`[sidebar]`

.Sidebar Block
****
Delimit by four asterisks (`*`).

.List
* Item 1

.Source Code
[source, TOML]
----
[supported]
TOML = highlight
----
****

.example attribute
[example]
`[example]`

.Example Block
====
Delimit by four equal signs (`=`).

.List
* Item 1

.Source Code
[source, julia]
----
println("Hello World")
----
====

.quote attribute
[quote,attribution,citation title and information]
Quote or excerpt text

.Quoted Paragraph
"Quote or
excerpt text"
-- attribution, citation title and information

.Quote Block
[quote,attribution,citation title and information]
____
Delimit by four underscores (`_`).

.List
* Item 1

.Source Code
[source, Zig]
----
const std = @import("std");

pub fn main() void {
    std.debug.print("Hello, {s}!\n", .{"World"});
}
----

.Nest
[quote,attribution,citation title and information]
______
Nest
______
____

.verse attribute
[verse,author,title]
Paragraph

.Verse Block
[verse,author,title]
____
First Block

Second Block
____

:attribute_substitutions_url: {asciidoc_docs_url}/attributes/positional-and-named-attributes/#substitutions
:author_link: {attribute_substitutions_url}[author]
:title_link: {attribute_substitutions_url}[title]
.Link
[verse,'{author_link}','{title_link}']
____
Quote single quotation mark (')
____

.Source Code
[source, bash]
----
#!/usr/bin/env bash

set -o nounset

function hello() {
  printf "Hello World!!"
}

hello
----

.Shorthand
[, console]
----
$ echo "Hello World"
Hello World
$ asciidoctor --version
Asciidoctor 2.0.20 [https://asciidoctor.org]
Runtime Environment (ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:UTF-8 ex:UTF-8)
----

:hello: Hello World
.Use Attributes
[source, AsciiDoc, subs="+attributes"]
----
\{hello} is {hello}
Set the subs attribute on a block to attributes.
----

.listing attribute
[listing]
`[listing]`

.Listing Block
----
Delimit by four hyphen signs (`-`).

.List
* Item 1

.Source Code
[source, jesth]
------
name = 'jesth'
------
----

.Use document attributes
[listing, subs=+attributes]
$ asciidoctor {docname}{docfilesuffix}

.Indent (add a space)
 ~/.config -> ~/dotfiles/config

.literal attribute
[literal]
`[literal]`

.Literal Block
....
Delimit by four periods (`.`).

.List
* Item 1

.Source Code
[source, cue]
----
typesAreValues: {
  name: string
}
----
....

.Use document attributes
[literal, subs=+attributes]
$ asciidoctor {docname}{docfilesuffix}

:!icons:

.`:!icons:`
 Callout numbers are text <1>

<1> `<1>`

:icons: font

.`:icons: font`
 Callout numbers are icon of Font-Awesome <1>

<1> `<1>`

.Block
----
one two <1> <2>
three <3>
four five <4><5>
----
<1> `<1>`
<2> `<2>`
<3> `<3>`
<4> `<4>`
<5> `<5>`

.Default
[source, Julia]
----
    function hello_world()
      run(Cmd(["echo", "Hello World"]))
    end

    hello_world()
----

.`indent=0`
[source, Julia, indent=0]
----
    function hello_world()
      run(Cmd(["echo", "Hello World"]))
    end

    hello_world()
----

.`indent=2`
[source, Julia, indent=2]
----
    function hello_world()
      run(Cmd(["echo", "Hello World"]))
    end

    hello_world()
----

.`indent=10`
[source, Julia, indent=10]
----
    function hello_world()
      run(Cmd(["echo", "Hello World"]))
    end

    hello_world()
----

.Table block delimiter is `|===`
|===
|row 1
|row 2
|===

.Add Header
|===
|Column 1 Header |Column 2 Header

|Column 1 row 1  |Column 2 row 1
|Column 1 row 2  |Column 2 row 2
|===

.Add Footer
[options="footer"]
|===
|Column 1 row 1  |Column 2 row 1
|Column 1 row 2  |Column 2 row 2

|Column 1 Footer |Column 2 Footer
|===

.Span Columns and Rows
|===
|Column 1 row 1        |Column 2 row 1 |Column 3 row 1
2+|Column 1 & 2 row 2                  |Column 3 row 2
.2+|Column 1 row 3 & 4 |Column 2 row 3 |Column 3 row 3
                       |Column 2 row 4 |Column 3 row 4
2.2+|Column 1 & 2 row 5 & 6            |Column 3 row 5
                                       |Column 3 row 6
|===