Important
 这个页面是为了从以前版本的Asciidoctor升级到最新稳定版本的Asciidoctor的用户准备的。如果你是从AsciiDoc.py迁移过来的，查看asciidoc-py.html。

当您升级Asciidoctor时，可能还需要在您的AsciiDoc文档中更新一些语法和属性。主要版本的发布可能会包括新的AsciiDoc语法功能，以及使语法更加一致的语法更改。

更新和弃用的功能

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

内联格式化

Feature Deprecated New Notes

italic text

'italic text'

_italic text_

允许在`compat-mode`下使用。 参见 asciidoc:text:italic.html。

monospace text

+monospace text+

`monospace text`

允许在`compat-mode`下使用。 参见 asciidoc:text:monospace.html。

literal monospace text

`literal monospace text`

`+literal monospace text+`

允许在`compat-mode`下使用。 参见 Literal monospace。

圆弧形的“double quotes”

``double quotes''

"`double quotes`", 编辑器快捷键，或 Unicode 字符的数值字符引用形式

参见 asciidoc:text:quotation-marks-and-apostrophes.html。

圆弧形的‘single quotes’

`single quotes'

'`single quotes`', 编辑器快捷键，或 Unicode 字符的数值字符引用形式

参见 asciidoc:text:quotation-marks-and-apostrophes.html。

目录

特性 已弃用 新的 注释

可滚动的，左侧边栏目录

toc2

:toc: left

参见 asciidoc:toc:position.html。

目录位置

toc-placement 和 toc-position

:toc: <value>

参见 asciidoc:toc:position.html。

用户指定的目录位置

:toc-placement: manual

:toc: macro

参见 asciidoc:toc:position.html。

文档标题

特性 已弃用 新特性 注释

双行样式（setext）文档标题

标题
=====

= 标题

Asciidoctor 接受双行标题样式来设置文档标题。 但是，使用它会隐式设置 compat-mode。 要使用新语法，请使用 = 标题 或显式取消设置 compat-mode。 参见 asciidoc:document:title.html。

应用程序编程接口

特性 已弃用 新的

渲染类方法

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

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

新功能

访问ROOT:whats-new.html查看Asciidoctor新功能的完整列表。