源代码下载: 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 协定进行许可。