Paragraphs don't require any special markup in AsciiDoc.
A paragraph is just one or more lines of consecutive text.

To begin a new paragraph, separate it by at least one blank line.

To preserve a line break, end the line in a space followed by a plus sign. +
This results in a visible line break (e.g., `<br>`) between the lines.

A normal paragraph.

 A sequence of lines that begin with at least one space is a literal paragraph.
 Literal paragraphs are treated as preformatted text.
 The text is shown in a fixed-width font
 and endlines are preserved.

Another normal paragraph.

NOTE: An admonition paragraph draws the reader's attention to
auxiliary information.
Its purpose is determined by the label
at the beginning of the paragraph.

Here are the other built-in admonition types:

TIP: Pro tip...

IMPORTANT: Don't forget...

WARNING: Watch out for...

CAUTION: Ensure that...

[.lead]
This text will be styled as a lead paragraph (i.e., larger font).

_italic phrase_

__i__talic le__tt__ers

*bold phrase*

**b**old le**tt**ers

*_bold italic phrase_*

**__b__**old italic le**__tt__**ers

`monospace phrase` and le``tt``ers

`_monospace italic phrase_` and le``__tt__``ers

`*monospace bold phrase*` and le``**tt**``ers

`*_monospace bold italic phrase_*` and le``**__tt__**``ers

`+inline literal passthrough+` (monospace text without substitutions)

Do werewolves believe in [small]#small print#?

[big]##O##nce upon an infinite loop.

^super^script phrase

~sub~script phrase

'`single smart quotes`'

"`double smart quotes`"

//toc::[]

= My Document's Title

My document provides...

= My Document's Title
Doc Writer <[email protected]>

My document provides...

= My Document's Title
Doc Writer <[email protected]>
v1.0, 2014-01-01

My document provides...

= My Document's Title
Doc Writer <[email protected]>
v1.0, 2014-01-01
:toc:
:imagesdir: assets/images
:homepage: http://asciidoctor.org

My document provides...

= Document Title (Level 0)

== Level 1 Section

=== Level 2 Section

==== Level 3 Section

===== Level 4 Section

====== Level 5 Section

== Another Level 1 Section

= Document Title (Level 0)

== Section Level 1

=== Section Level 2

==== Section Level 3

===== Section Level 4

====== Section Level 5

= Section Level 0

[[primitives-nulls]]
== Primitive types and null values

= Reference Documentation
Lead Developer

This is documentation for project X.

include::basics.adoc[]

include::installation.adoc[]

include::example.adoc[]

:asciidoctor-source: https://raw.github.com/asciidoctor/asciidoctor/master

include::{asciidoctor-source}/README.adoc[]

'''

<<<

* Edgar Allen Poe
* Sheri S. Tepper
* Bill Bryson

//^

* Kevin Spacey
* Jeremy Piven

* level 1
** level 2
*** level 3
**** level 4
***** level 5
* level 1

- [*] checked
- [x] also checked
- [ ] not checked
-     normal list item

. Step 1
. Step 2
. Step 3

. Step 1
. Step 2
.. Step 2a
.. Step 2b
. Step 3

. level 1
.. level 2
... level 3
.... level 4
..... level 5
. level 1

first term:: definition of first term
section term:: definition of second term

GEM
  remote: https://rubygems.org/
  specs:
    asciidoctor (0.1.4)

PLATFORMS
  ruby

DEPENDENCIES
  asciidoctor (~> 0.1.4)

require 'sinatra'

get '/hi' do
  "Hello World!"
end

require 'sinatra' (1)

get '/hi' do      (2)
  "Hello World!"  (3)
end

line of code  (1)
line of code  (2)
line of code  (3)

<section>
  <title>Section Title</title> (1)
</section>

<meta name="viewport"
  content="width=device-width, initial-scale=1.0">
====

.AsciiDoc history
****
AsciiDoc was first released in Nov 2002 by Stuart Rackham.
It was designed from the start to be a shorthand syntax
for producing professional documents like DocBook and LaTeX.
****

.Sample document
====
Here's a sample AsciiDoc document:

[listing]
....
= Title of Document
Doc Writer
:toc:

This guide provides...
....

The document header is useful, but not required.
====

[NOTE]
====
An admonition block may contain complex content.

.A list
- one
- two
- three

Another paragraph.
====

[quote, Abraham Lincoln, Soldiers' National Cemetery Dedication]
____
Four score and seven years ago our fathers brought forth
on this continent a new nation...
____

[quote, Albert Einstein]
A person who never made a mistake never tried anything new.

____
A person who never made a mistake never tried anything new.
____

"I hold it that a little rebellion now and then is a good thing,
and as necessary in the political world as storms in the physical."
-- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11

[, Richard M. Nixon]
""
When the President does it, that means that it's not illegal.
""

++++
<p>
Content in a passthrough block is passed to the output unprocessed.
That means you can include raw HTML, like this embedded Gist:
</p>

<script src="http://gist.github.com/mojavelinux/5333524.js">
</script>
++++

--
An open block can be an anonymous container,
or it can masquerade as any other block.
--

[source]
--
puts "I'm a source block!"
--

:version: 0.1.4

[source,xml]
[subs="verbatim,attributes"]
----
<dependency>
  <groupId>org.asciidoctor</groupId>
  <artifactId>asciidoctor-java-integration</artifactId>
  <version>{version}</version>
</dependency>
----

[[goals]]
[role="incremental"]
* Goal 1
* Goal 2

[#goals.incremental]
* Goal 1
* Goal 2

[[free_the_world]][big goal]_free the world_

[#free_the_world.big.goal]_free the world_

[rolename]`escaped monospace text`

[options="header,footer,autowidth"]
|===
|Cell A |Cell B
|===

[%header%footer%autowidth]
|===
|Cell A |Cell B
|===

// A single-line comment.

////
A multi-line comment.

Notice it's a delimited block.
////

.Table Title
|===
|Name of Column 1 |Name of Column 2 |Name of Column 3 (1)
(2)
|Cell in column 1, row 1
|Cell in column 2, row 1
|Cell in column 3, row 1

|Cell in column 1, row 2
|Cell in column 2, row 2
|Cell in column 3, row 2
|===

[cols="2*", options="header"] (1)
|===
|Name of Column 1
|Name of Column 2

|Cell in column 1, row 1
|Cell in column 2, row 1

|Cell in column 1, row 2
|Cell in column 2, row 2
|===

[cols="1,1,2", options="header"] (1)
.Applications
|===
|Name
|Category
|Description

|Firefox
|Browser
|Mozilla Firefox is an open-source web browser.
It's designed for standards compliance,
performance, portability.

|Arquillian
|Testing
|An innovative and highly extensible testing platform.
Empowers developers to easily create real, automated tests.
|===

[cols="2,2,5a"]
|===
|Firefox
|Browser
|Mozilla Firefox is an open-source web browser.

It's designed for:

* standards compliance
* performance
* portability

http://getfirefox.com[Get Firefox]!
|===

[format="csv", options="header"]
|===
Artist,Track,Genre
Baauer,Harlem Shake,Hip Hop
The Lumineers,Ho Hey,Folk Rock
|===

,===
Artist,Track,Genre

Baauer,Harlem Shake,Hip Hop
,===

:===
Artist:Track:Genre

Robyn:Indestructable:Dance
:===

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

|===
|Shortcut |Purpose

|kbd:[F11]
|Toggle fullscreen

|kbd:[Ctrl+T]
|Open a new tab

|kbd:[Ctrl+Shift+N]
|New incognito window

|kbd:[Ctrl + +]
|Increase zoom
|===

To save the file, select menu:File[Save].

Select menu:View[Zoom > Reset] to reset the zoom level to the default setting.

Press the btn:[OK] button when you are finished.

Select a file in the file navigator and click btn:[Open].

:homepage: http://asciidoctor.org
:docslink: http://asciidoctor.org/docs[Asciidoctor's Docs]
:desc: Asciidoctor is a mature, plain-text document format for +
       writing notes, articles, documentation, books, and more. +
       It's also a text processor & toolchain for translating +
       documents into various output formats (i.e., backends), +
       including HTML, DocBook, PDF and ePub.
:checkedbox: pass:normal[`[✔]`]

Check out {homepage}[Asciidoctor]!

{desc}

Check out {docslink} too!

{checkedbox} That's done!

[caption=""]
.Parts{counter2:index:0}
|===
|Part Id |Description

|PX-{counter:index}
|Description of PX-{index}

|PX-{counter:index}
|Description of PX-{index}
|===

\*Stars* is not rendered as bold text.
The asterisks around the word are preserved.

\{author} is not resolved to the author name.
The curly brackets around the word are preserved.

The backslash character is automatically removed.

$$*Stars*$$ is not rendered as bold text.
The asterisks around the word are preserved.

$$&$$ renders as an XML entity instead of &.

+++<u>underline me</u>+++ renders as underlined text.

pass:[<u>underline me</u>] also renders as underlined text.

`Text in {backticks}` renders exactly as entered, in `monospace`.
The attribute reference is not resolved.

= AsciiDoc Writer's Guide
Doc Writer <[email protected]>
v1.0, 2013-01-01
:toc:

= AsciiDoc Writer's Guide
Doc Writer <[email protected]>
v1.0, 2013-01-01
:toc: right

'The Pragmatic Programmer' <<prag>> should be required reading for
all developers.

[bibliography]
- [[[prag]]] Andy Hunt & Dave Thomas. 'The Pragmatic Programmer:
  From Journeyman to Master'. Addison-Wesley. 1999.
- [[[seam]]] Dan Allen. 'Seam in Action'. Manning Publications.
  2008.

A statement.footnote:[Clarification about this statement.]

A bold statement.footnoteref:[disclaimer,These opinions are my own.]

Another bold statement.footenoteref:[disclaimer]

# Document Title (Level 0)

## Section Level 1

### Section Level 2

#### Section Level 3

##### Section Level 4

###### Section Level 5

```ruby
require 'sinatra'

get '/hi' do
  "Hello World!"
end
```

> I hold it that a little rebellion now and then is a good thing,
> and as necessary in the political world as storms in the physical.
> -- Thomas Jefferson, Papers of Thomas Jefferson: Volume 11

> > What's new?
>
> I've got Markdown in my AsciiDoc!
>
> > Like what?
>
> * Blockquotes
> * Headings
> * Fenced code blocks
>
> > Is there more?
>
> Yep. AsciiDoc and Markdown share a lot of common syntax already.

---

- - -

***

* * *

Paragraphs don't require any special markup in AsciiDoc.
A paragraph is just one or more lines of consecutive text.

To begin a new paragraph, separate it by at least one blank line.

To preserve a line break, end the line in a space followed by a plus sign. +
This results in a visible line break (e.g., `<br>`) between the lines.

A normal paragraph.

 A sequence of lines that begin with at least one space is a literal paragraph.
 Literal paragraphs are treated as preformatted text.
 The text is shown in a fixed-width font
 and endlines are preserved.

Another normal paragraph.

NOTE: An admonition paragraph draws the reader's attention to
auxiliary information.
Its purpose is determined by the label
at the beginning of the paragraph.

Here are the other built-in admonition types:

TIP: Pro tip...

IMPORTANT: Don't forget...

WARNING: Watch out for...

CAUTION: Ensure that...

[.lead]
This text will be styled as a lead paragraph (i.e., larger font).

_italic phrase_

__i__talic le__tt__ers

*bold phrase*

**b**old le**tt**ers

*_bold italic phrase_*

**__b__**old italic le**__tt__**ers

`monospace phrase` and le``tt``ers

`_monospace italic phrase_` and le``__tt__``ers

`*monospace bold phrase*` and le``**tt**``ers

`*_monospace bold italic phrase_*` and le``**__tt__**``ers

`+inline literal passthrough+` (monospace text without substitutions)

Do werewolves believe in [small]#small print#?

[big]##O##nce upon an infinite loop.

^super^script phrase

~sub~script phrase

'`single smart quotes`'

"`double smart quotes`"

//toc::[]

= My Document's Title

My document provides...

= My Document's Title
Doc Writer <[email protected]>

My document provides...

= My Document's Title
Doc Writer <[email protected]>
v1.0, 2014-01-01

My document provides...

= My Document's Title
Doc Writer <[email protected]>
v1.0, 2014-01-01
:toc:
:imagesdir: assets/images
:homepage: http://asciidoctor.org