段落を記載するのに特別なマークアップは不要です。
１行から複数行に渡り連続して記述するだけです。

新しい段落を始める時は、最低１行の空白行を入れてください。

プラスを行末に指定すると改行とみなされます。 +
ルビーの色は赤です。 +
トパーズの色は青です。

[%hardbreaks]
段落にhardbreaksを指定するとテキスト上での改行が、
そのまま改行として表示されます。
ルビーの色は赤です。
トパーズの色は青です。

段落その１

 １つ以上の空白で始まる連続した行はリテラル段落とみなされます。
 リレラル段落はあらかじめフォーマットされたテキストとして扱われます。
 テキストは固定幅のフォントで表示され、
 改行はそのまま改行として表示されます。

段落その２

NOTE: 脚注段落は補足情報を示すものです。
段落冒頭のラベルによって脚注の種類を使い分けることができます。

NOTE以外にも下記のような脚注があります。

TIP: チップスを記述します。

IMPORTANT: 重要事項を記述します。

WARNING: 警告を記述します。

CAUTION: 注意を記述します。

[.lead]
この段落は、第一段落のスタイル(文字が大きいスタイル)が適用されます。

フォーマット対象文字列の左右にスペースがある場合は、１つの演算子で囲みます。 +
スペースが無い場合(文章の途中、単語の一部)などの場合は、2つの演算子で囲みます。

*太字の語句* と **太**字の文**字**

_イタリックの語句_ と __イタ__リックの文__字__

*_太字のイタリックの語句_* と **__太字のイタ__**リックの文**__字__**

`モノスペースの語句`と``モノ``スペースの文``字``

`*モノスペースの太字の語句*` と ``**モノ**``スペースの太字の語``**句**``

`_モノスペースのイタリックの語句_` と ``__モノ__``スペースのイタリックの文``__字__``

`*_モノスペースの太字のイタリックの語句_*` と ``**__モノ__**``スペースの太字のイタリックの``**__文字__**``

狼男は #シナモン# アレルギーです。

狼男たちは [.small]#小さい活字# を読みましたか?

全ての [.underline]#コア# はどこに流れたのですか?

[.line-through]#10# 20台のVMを用意する必要があります。

[.big]#い# ったん無限ループが起きると

^上付き文字の^サンプルテキスト

~下付き文字の~サンプルテキスト

"`ダブルカーブクォート`"

'`シングルカーブクォート`'

Olaf's desk was a mess.

All of the werewolves`' desks were a mess.

Olaf had been with the company since the `'60s.

= 本ドキュメントのタイトル

本ドキュメントは...

= 本ドキュメントのタイトル
著者名 <doc.writer@asciidoctor.org>


本ドキュメントは...

= 本ドキュメントのタイトル
著者名 <doc.writer@asciidoctor.org>
v1.0, 2014-01-01

本ドキュメントは...

= 本ドキュメントのタイトル
著者名 <doc.writer@asciidoctor.org>
v1.0, 2014-01-01
// ドキュメントの属性を下記のように定義します。
:toc:
:imagesdir: assets/images
:homepage: http://asciidoctor.org

本ドキュメントは...

= ドキュメントのタイトル(レベル０)

== レベル１のセクションのタイトル

=== レベル２のセクションのタイトル

==== レベル３のセクションのタイトル

===== レベル４のセクションのタイトル

====== レベル５のセクションのタイトル

== 別のレベル１のセクションのタイトル

= ドキュメントのタイトル(レベル０)

== セクション レベル１

=== セクション レベル２

==== セクション レベル３

===== セクション レベル４

====== セクション レベル５

== セクション レベル１

[[primitives-nulls]]
== セッションタイトルの上に[[]]で指定することでidを指定できます。

= ドキュメントのリファレンス
開発者向け

includeステートメントを指定することで別ファイルをインクルードできます。 +
ファイル名の後の[]は、インクルードファイルのタグや行数を指定して、 +
ファイルの一部だけをインクルードすることができます。

include::basics.adoc[]

include::installation.adoc[]

include::example.adoc[]

inclueステートメントにはURIを指定することもできます。

include::https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/README.adoc[]

```

<<<

*を行冒頭に指定することで順序無しリストを定義できます。

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

* レベル１
** レベル２
*** レベル３
**** レベル４
***** レベル５
* レベル１

- [*] チェック済みの要素
- [x] これもチェック済みの要素
- [ ] 未チェックの要素
-    通常の順序無しリストの要素

. 手順１
. 手順２
. 手順３

. 手順１
. 手順２
.. 手順２a
.. 手順２b
. 手順３

. レベル１
.. レベル２
... レベル３
.... レベル４
..... レベル５
. レベル１

第一項:: 第一項の定義
第二項:: 第二項の定義

第一項::
第一項の定義
第二項::
第二項の定義

[qanda]
Asciidoctorとは何ですか?::
  AsciiDocをRubyで実装したものです。
生命、宇宙、そして万物についての究極の疑問の答えは何ですか？:: 42です。

オペレーティング システム::
  Linux:::
    . Fedora
      * デスクトップ
    . Ubuntu
      * デスクトップ
      * サーバ
  BSD:::
    . FreeBSD
    . NetBSD

クラウド プロバイダー::
  PaaS:::
    . OpenShift
    . CloudBees
  IaaS:::
    . Amazon EC2
    . Rackspace

* リストの要素は必ず段落を１つ以上含みます。
段落のコンテンツはインデントしていても折り返し可能です。
+
リストの途中に段落やブロックを挿入するには、
その上と下の行にリスト継続用マーカを記述します。
+
リスト継続用マーカ:: プラス記号(`{plus}`)を使います。

* リレラル段落はリスト継続用マーカは不要です。

 $ gem install asciidoctor

* AsciiDocのリストは複雑なコンテンツを含むことができます。
+
[cols="2", options="header"]
|===
|アプリケーション
|言語

|Asciidoc
|Python

|Asciidoctor
|Ruby
|===

http://asciidoctor.org - 自動でリンクになります。

http://asciidoctor.org[Asciidoctor]

https://github.com/asciidoctor[Asciidoctor @ *GitHub*]

link:++http://example.org/?q=[a b]++[空白を含むURL]

link:http://example.org/?q=%5Ba%20b%5D[特殊文字を含んだリンク]

link:\\server\share\whitepaper.pdf[Whitepaper]

link:index.html[ドキュメント]

devel@dicsuss.arquillian.org - 自動でリンクになります。

mailto:devel@dicsuss.arquillian.org[Arquillianについて議論する]

mailto:devel-join@discuss.arquillian.org[購読する, 購読します, 参加したいです!] - メールの件名と本文が指定できます。

irc://irc.freenode.org/#asciidoctor

http://discuss.asciidoctor.org[Asciidoctorについて議論する, role="external", window="_blank"]

http://discuss.asciidoctor.org[Asciidoctorについて議論する^]

http://example.org["Google, Yahoo, Bing^", role="teal"]

[[ブックマーク-A]]インラインアンカーは任意のコンテンツを参照可能にします。

[#ブックマーク-B]#インラインアンカーはこのように指定することもできます。#

anchor:ブックマーク-C[]相互参照

[[ブックマーク-D,最終パラグラフ]]xreflabelは相互参照リンクのリンクとして使用されます。

日本語のセクションタイトルの場合、idはタイトル名の冒頭に_を付けたものになります。
内部相互参照は第１引数にid、第２引数に表示名を指定してください。

<<_段落,段落>>のように記述すると、段落のセクションタイトルへのリンクが表示されます。

セクションタイトルへのリンクは、<<_セクションタイトル,セクション>>のように記述します。

内部相互参照と同じような記述方法で、第１引数のidの前に`ドキュメント名#`を指定します。

<<document-b.adoc#section-b,Section B>> を参照してください。

image::sunset.jpg[]

image::sunset.jpg[夕日]

.山の夕日
[#image-sunset]
[caption="図 1:", link=http://www.flickr.com/photos/javh/5448336655]
image::sunset.jpg[夕日, 300, 200]

image::http://asciidoctor.org/images/octocat.jpg[GitHub mascot]

クリック image:icons/play.png[Play, title="Play"] パーティーを開始する。

クリック image:icons/pause.png[title="Pause"] 休憩する。

image::sunset.jpg[夕日, 150, 150, role="right"] なんて美しい夕日！

= ドキュメントタイトル
:data-uri:

video::video_file.mp4[]


video::video_file.mp4[width=640, start=140, options=autoplay]

video::TabMg56daZ0[youtube]

video::22439234[vimeo]

`types` や `methods` のような参照コード。

 コードスニペットは行冒頭に１つのスペースを挿入してください。

....
error: The requested operation returned error: 1954 Forbidden search for defensive operations manual
absolutely fatal: operation initiation lost in the dodecahedron of doom
would you like to die again? y/n
....

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

PLATFORMS
  ruby

DEPENDENCIES
  asciidoctor (~> 0.1.4)
----

[[app-listing]]
[source,ruby]
.app.rb
----
require 'sinatra'

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

[source,ruby]
----
require 'sinatra' // <1>

get '/hi' do // <2>
  "Hello World!" // <3>
end
----
<1> Library import
<2> URL mapping
<3> HTTP response body

----
ソースコード //<1>
ソースコード #<2>
ソースコード ;;<3>
----
<1> C言語用の行末吹き出しコメント
<2> Ruby、Python、Perlなどの行末吹き出しコメント
<3> Clojure用の行末吹き出しコメント

[source,xml]
----
<section>
  <title>Section Title</title> <!--1-->
</section>
----
<1> セクションタイトルをここで定義します。

[source,java]
----
include::StringUtils.java[]
----

[source,java]
----
include::{sourcedir}/StringUtils.java[]
----

[source,java,indent=0]
----
include::{sourcedir}/StringUtils.java[lines=5..7]
----

[source,java,indent=1]
----
include::{sourcedir}/StringUtils.java[lines=5..7]
----


[source,java,indent=2]
----
include::{sourcedir}/StringUtils.java[lines=5..7]
----

[source,xml]
<meta name="viewport"
  content="width=device-width, initial-scale=1.0">


この行は通常のコンテンツです。

.AsciiDocの歴史
****
AsciiDocは、Stuart Rackhamが2002年11月にリリースした
AsciiDocは、DocBookやLaTeXのような専門的な文章を作成するためのもので、
より簡単な文法で専門的は文章が書けるようにデザインされていた。
****

.サンプルドキュメント
====
これはAsciiDocのドキュメントのサンプルです。

[listing]
....
= ドキュメントのタイトル
著者名
:toc:

本ガイドは...
....

ドキュメントヘッダーは、必須ではありません。
====

[NOTE]
====
脚注ブロックは複雑はコンテンツを含むことができます。

.リスト
- 一
- 二
- 三

別のパラグラフ
====

[quote, Abraham Lincoln, Address delivered at the dedication of the Cemetery at Gettysburg]
____
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.
____

[quote, Charles Lutwidge Dodgson, 'Mathematician and author, also known as http://en.wikipedia.org/wiki/Lewis_Carroll[Lewis Carroll]']
____
If you don't know where you are going, any road will get you there.
____

"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>
``+``で囲まれたブロックは、変換処理を行わずにそのままHMTLに出力されます。
</p>

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

--
オープンブロックは汎用的に使えます。
--

[source]
--
puts "これはソースブロック！"
--

: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]`monospace text`

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

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

// 一行コメントです。

////
複数行コメントです。

これはDelimitedブロックです。
////

.テーブルタイトル
|===
|カラム名1 |カラム名2 |カラム名3 (1)
(2)
|セル11
|セル12
|セル13

|セル21
|セル22
|セル23
|===

[cols="2*", options="header"] (1)
|===
|カラム名1
|カラム名2

|セル11
|セル12

|セル21
|セル22
|===

[cols="1,1,2", options="header"](1)
.テーブルタイトル
|===
|名前
|カテゴリ
|説明

|Firefox
|ブラウザ
|オープンソースのブラウザです。
標準仕様に準拠しており、高パフォーマンス、高い可搬性という特徴があります。

|Arquillian
|テスト
|革新的かつ高度に拡張可能なテストプラットフォームです。
開発者が実際の自動テストを簡単に作成できるようにします。
|===

[cols="2,2,5a"]
|===
|Firefox
|ブラウザ
|FirefoxはオープンソースのWEBブラウザです。

下記のような特徴があります。:

* 標準仕様準拠
* 高パフォーマンス
* 高い可搬性

http://getfirefox.com[Firefoxをダウンロードする]!
|===

[format="csv", options="header"]
|===
アーティスト,トラック,ジャンル
Baauer,Harlem Shake,Hip Hop
The Lumineers,Ho Hey,Folk Rock
|===

[format="csv", options="header"]
,===
アーティスト,トラック,ジャンル

Baauer,Harlem Shake,Hip Hop
The Lumineers,Ho Hey,Folk Rock
,===

|===
include::customers.csv[]
|===

:===
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
|===

|===
|ショートカット|目的

|kbd:[F11]
|全画面表示

|kbd:[Ctrl+T]
|新規タブを開く

|kbd:[Ctrl+Shift+N]
|シークレットウインドウを開く

|kbd:[Ctrl + +]
|ズーム
|===

ファイルを保存するにはmenu:File[Save]を選択します。

拡大率をデフォルトに戻すにはmenu:View[Zoom > Reset]を選択します。

完了したら btn:[OK] ボタンを押してください。

ナビゲーターでファイルを選択し、 btn:[開く] をクリックしてください。

:homepage: http://asciidoctor.org
:docslink: http://asciidoctor.org/docs[Asciidoctor's Docs]
:summary: 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[{startsb}✔{endsb}]

Check out {homepage}[Asciidoctor]!

{summary}

Check out {docslink} too!

{checkedbox} That's done!

[caption=""]
.章{counter2:index:0}
|===
|章 |説明

|第{counter:index}章
|第{index}章の説明

|第{counter:index}章
|第{index}章の説明
|===

\*アスタリスク* は太字として描画されません。
単語の左右のアスタリスクは変換されません。

\{author} は著者名と解釈されません。
単語の左右の括弧は変換されません。

バックスラッシュは変換時に自動で除去されます。

+++<u>下線付きのテキスト</u>+++ は下線付きテキストとして表示されます。

pass:[<u>下線付きのテキスト</u>] は下線付きテキストとして表示されます。

= AsciiDoc Writer's Guide
Doc Writer <doc.writer@asciidoctor.org>
v1.0, 2013-08-01
:toc:

= AsciiDoc Writer's Guide
Doc Writer <doc.writer@asciidoctor.org>
v1.0, 2014-08-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.

声明その１。footnote:[この声明のついての明確化]

大胆な声明その１.footnoteref:[disclaimer, Opinions are my own.]

大胆な声明その２.footnoteref:[disclaimer]

# ドキュメントのタイトル(レベル０)

## セクション レベル１

### セクション レベル２

#### セクション レベル３

##### セクション レベル４

###### セクション レベル５

## セクション レベル１

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

---

- - -

***

* * *