📜  asciidoc (1)

📅  最后修改于: 2023-12-03 14:39:21.431000             🧑  作者: Mango

AsciiDoc 简介

AsciiDoc 是一种轻量级标记语言,类似于 Markdown,但比 Markdown 更加强大。AsciiDoc 用 plain text 编写,可以被转换成多种格式,包括 HTML、PDF、EPUB、DocBook 等。AsciiDoc 有一些 Markdown 没有的特性,比如宏定义、交叉引用、索引、文献引用等。AsciiDoc 也可以使用多种编译器进行编译,例如 Asciidoctor、Pandoc、DocBook 等。

特点
  • 简单易学;
  • 能够快速生成多种格式的文档;
  • 可以定义样式,满足用户的需求;
  • 支持代码高亮、注释、跨文档引用、脚注等常用功能。
语法

AsciiDoc 的语法和 Markdown 有些相似,但也有一些不同。

标题

和 Markdown 一样,用 # 表示标题。但是不同的是,AsciiDoc 标题前面必须空一行。

# Level 1

## Level 2

### Level 3
段落

AsciiDoc 段落前面需要空一行。

This is the first paragraph.

This is the second paragraph.
强调

和 Markdown 一样,用 * 或 _ 表示强调。

This is *emphasis*.
This is _emphasis_.
列表

AsciiDoc 支持有序列表和无序列表。有序列表使用数字加点,无序列表使用符号加空格。和 Markdown 不一样的是,AsciiDoc 不需要和段落之间加空行。

== Ordered List

. First item
. Second item
. Third item
 
== Unordered List

* First item
* Second item
* Third item
引用

和 Markdown 一样,用 > 表示引用。

> This is a quote.
代码块

和 Markdown 一样,用 ` 表示行内代码,用 ``` 表示代码块。

This is `inline code`.

This is a code block.


### 超链接

和 Markdown 一样,用 [link text](url) 表示超链接。

```markdown
This is a [link](http://example.com).
图片

和 Markdown 一样,用 表示图片。

![Alt text](/path/to/img.jpg)
总结

AsciiDoc 是一种优秀的轻量级标记语言,具有丰富的特性和强大的功能。它易于学习和使用,能够快速生成多种格式的文档,是程序员们不容错过的工具。