源代码下载:asciidoc-cn.md
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 文档有两种工具:
- AsciiDoc: 原版的 Python 实现,在支流 Linux 发行版中已附带,目前处于稳固版本保护模式。
- Asciidoctor: 应用 Ruby 的另一种实现,也能够从 Java 和 JavaScript 中应用。它处于踊跃的开发中,指标是用新个性和输入格局扩大 AsciiDoc 的语法。
以下是 Asciidoctor 实现的相干链接 :
- Markdown – AsciiDoc 语法比拟:并列比拟个别 Markdown 和 AsciiDoc 的元素。
- 入门:装置和疾速启动指南,帮忙构建简略的文档。
* Asciidoctor 用户手册: 残缺的单文档指南,蕴含语法参考、示例、渲染工具等。
有倡议?或者发现什么谬误?在 Github 上开一个 issue,或者发动 pull request!
原著 Ryan Mavilia,并由 0 个好心人批改。
Translated by: Liu Yihua
© 2022 Ryan Mavilia, Abel Salgado Romero
本作品采纳 CC BY-SA 3.0 协定进行许可。