summaryrefslogtreecommitdiffhomepage
path: root/zh-cn/asciidoc-cn.html.markdown
blob: 74eed4452efdb24eaf54409759a4d4ed2eb6a96a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
---
language: asciidoc
filename: asciidoc-cn.md
contributors:
    - ["Ryan Mavilia", "http://unoriginality.rocks/"]
    - ["Abel Salgado Romero", "https://twitter.com/abelsromero"]
translators:
    - ["Liu Yihua", "https://github.com/yihuajack"]
lang: zh-cn
---

AsciiDoc 是一种类似于 Markdown 的标记语言,它可以用来写从书到博客的任何东西。它由 Stuart Rackham 在 2002 年发明,它的语言很简单,但同时也可以有丰富的定制。

文档标题

标题是可选的,且不可以包含空行。它必须离正文空出至少一个空行。

仅标题

```
= 文档标题

文档的第一句话。
```

标题和作者

```
= 文档标题
张三 <san.zhang@learnxinyminutes.com>

文档开始。
```

多名作者的情形

```
= 文档标题
李四 <si@go.com>; 王五 <wu@yo.com>; 赵六 <xzhao@pirate.com>

有多名作者的文档开始。
```

版本行(需要作者行)

```
= 文档标题(第一版)
土豆人 <chip@crunchy.com>
v1.0, 2016-01-13

这篇关于炸薯条的文章会很有趣。
```

段落

```
段落不需要什么特别操作。

在两段之间用一个空行隔开。

当你需要换行时,添加一个 +
你就会得到一个换行符!
```

文本格式化

```
_用下划线创建斜体_
*用星号加粗*
*_组合起来用更有趣_*
`用重音符显示等宽字体`
`*加粗等宽字体*`
```

节标题

```
= 第 0 级 (一般只用于文档标题)

== 第 1 级 <h2>

=== 第 2 级 <h3>

==== 第 3 级 <h4>

===== 第 4 级 <h5>

```

列表

用星号创建无序列表。

```
* 甲
* 乙
* 丙
```

用句点创建有序列表。

```
. 项目 1
. 项目 2
. 项目 3
```

你可以用额外的星号或句点来嵌套最多五次列表。

```
* 甲 1
** 甲 2
*** 甲 3
**** 甲 4
***** 甲 5

. 甲 1
.. 甲 2
... 甲 3
.... 甲 4
..... 甲 5
```

## 补充材料

处理 AsciiDoc 文档有两种工具:

1. [AsciiDoc](http://asciidoc.org/): 原版的 Python 实现,在主流 Linux 发行版中已附带,目前处于稳定版本维护模式。
2. [Asciidoctor](http://asciidoctor.org/): 使用 Ruby 的另一种实现,也可以从 Java 和 JavaScript 中使用。它处于积极的开发中,目标是用新特性和输出格式扩展 AsciiDoc 的语法。

以下是 `Asciidoctor` 实现的相关链接:

* [Markdown - AsciiDoc 语法比较](http://asciidoctor.org/docs/user-manual/#comparison-by-example):并列比较一般 Markdown 和 AsciiDoc 的元素。
* [入门](http://asciidoctor.org/docs/#get-started-with-asciidoctor):安装和快速启动指南,帮助构建简单的文档。
* [Asciidoctor 用户手册](http://asciidoctor.org/docs/user-manual/): 完整的单文档指南,包含语法参考、示例、渲染工具等。