从 Asciidoctor 1.5.x 升级到 2.0

本页面适用于从 Asciidoctor 旧版本升级到最新稳定版 Asciidoctor 的用户。如果您是从 AsciiDoc.py 迁移，请参阅 从 AsciiDoc.py 迁移。

升级 Asciidoctor 时，您可能还需要更新 AsciiDoc 文档中的部分语法和属性。主版本发布可能包含新的 AsciiDoc 语法功能以及使其更一致的语法更改。

更新和已弃用的功能

下面列出的语法、属性和命令已更新或已弃用。在大多数情况下，它们已被提供改进功能的新功能所取代。

行内格式

Feature 已弃用 新 注释

斜体文本

'斜体文本'

_斜体文本_

在 compat-mode 下允许使用。请参阅 斜体。

代码文本

+代码文本+

`代码文本`

在 compat-mode 下允许使用。请参阅 代码。

字面代码文本

`字面代码文本`

`+字面代码文本+`

在 compat-mode 下允许使用。请参阅 字面代码。

弯引号“双引号”

``双引号''

"`双引号`"、编辑器按键绑定或数字字符引用的 Unicode 字符形式

请参阅 引号和撇号。

弯引号‘单引号’

`单引号'

'`单引号`'、编辑器按键绑定或数字字符引用的 Unicode 字符形式

请参阅 引号和撇号。

目录

Feature 已弃用 新 注释

可滚动、左边距 TOC

toc2

:toc: left

请参阅 定位 TOC。

TOC 位置

toc-placement 和 toc-position

:toc: <值>

请参阅 定位 TOC。

用户指定的 TOC 位置

:toc-placement: manual

:toc: macro

请参阅 定位 TOC。

文档头

Feature 已弃用 新 注释

两行样式（setext）文档标题

标题
=====

= 标题

Asciidoctor 接受两行标题样式来设置文档标题。但是，使用它会隐式设置 compat-mode。要使用新语法，请使用 = 标题 或显式取消设置 compat-mode。请参阅 文档标题。

API

Feature 已弃用 新

渲染类方法

.render(input, options = {}) ⇒ Object

.convert(input, options = {}) ⇒ Object

新功能

请访问 2.0 中的新功能 以获取 Asciidoctor 新功能的完整列表。