文档技术方案选型：AsciiDoc vs Markdown

**bold**

*bold*

**b**old

**b**old

*italic*

_italic_

__i__talic

`monospace`

`monospace`

`m`onospace

``m``onospace

`http://localhost:8080`
`/issue/{id}`

`+http://localhost:8080+`
`+/issue/{id}+`

[Asciidoctor](https://asciidoctor.org)

https://asciidoctor.org[Asciidoctor]

[user guide](user-guide.html)

link:user-guide.html[user guide]
xref:user-guide.adoc[user guide]

[get the PDF]({% raw %}{{ site.url }}{% endraw %}/assets/mydoc.pdf)

link:{site-url}/assets/mydoc.pdf[get the PDF]

See [Usage](#_usage).

<h2 id="_usage">Usage</h2>

See <<_usage>>.

== Usage

<h2 id="usage">Usage</h2>

[#usage]
== Usage

. [[step-1]]Download the software

![Logo](/images/logo.png)

image:logo.png[Logo]

image::/logo.png[Logo]

## Heading 2

== Heading 2

> Quoted text.
>
> Another paragraph in quote.

____
Quoted text.

Another paragraph in quote.
____

    $ gem install asciidoctor

 $ gem install asciidoctor

....
$ gem install asciidoctor
....

```java
public class Person {
  private String name;
  public Person(String name) {
    this.name = name;
  }
}
```

[source,java]
----
public class Person {
  private String name;
  public Person(String name) {
    this.name = name;
  }
}
----

* apples
* orange
  * temple
  * navel
* bananas

* apples
* oranges
** temple
** navel
* bananas

1. first
2. second
3. third

. first
. second
. third

***

* * *

---

- - -

___

_ _ _

'''

The `'90s popularized a new form of music known as "`grunge`" rock.
It'll turn out to have an impact that extended well beyond music.

---
layout: docs
title: Writing posts
prev_section: defining-frontmatter
next_section: creating-pages
permalink: /docs/writing-posts/
---

= Writing posts
:page-layout: base
:showtitle:
:prev_section: defining-frontmatter
:next_section: creating-pages

TIP: You can add line numbers to source listings by adding the word `numbered` in the attribute list after the language name.

.Lightweight Markup
****
Writing languages that let you type less and express more.
****

.Grocery list
* Milk
* Eggs
* Bread

include::intro.adoc[]

Go to the [home page][home].

[home]: https://example.org

:home: https://example.org

Go to the {home}[home page].

[.path]_Gemfile_