AsciiDoc图像宏有两种类型，块状和内联。如同所有宏一样，块状形式和内联形式通过宏名称后跟的冒号数量来区分。块状形式使用两个冒号(::)，而内联形式只使用一个冒号(:)。
屏蔽图像宏
一个[.term]*块级图像*在文档中被显示为独立的元素，即，在它自己的行上。块级图像由`image`宏名称指定，并跟随两个冒号(::)。它前面是一个空行，单独输入在一行上，然后后面跟着一个空行。
文件中的内容。
Unresolved directive in images.adoc - include::example$image.adoc[tag=base-co]
文档中的内容-
为了插入一个块状图像，请直接键入`image`宏名称，紧随其后是两个冒号(
::)。 -
在冒号之后，输入图像文件的目标路径。在目标路径之后直接键入一对方括号 (
[]) 以完成宏的设置。
屏蔽图像宏 的结果如下所示。
Unresolved directive in images.adoc - include::example$image.adoc[tag=base]
Unresolved directive in images.adoc - include::partial$image-target.adoc[]
您可以在方括号内指定一个逗号分隔的可选属性列表，也可以将其留空。如果您想指定替代文本，请在方括号内输入。
Unresolved directive in images.adoc - include::example$image.adoc[tag=alt]如果alt文本中包含逗号，您必须用双引号将alt文本括起来。双引号括起来的效果相当于将逗号从被解释为属性分隔符中转义出来。
Unresolved directive in images.adoc - include::example$image.adoc[tag=alt-with-comma]|
Note
|
尽管你可以用单引号来包围alt文本以转义逗号，但这么做会隐式地启用替换。除非你需要对alt文本应用替换，否则建议使用双引号作为包围标记。 |
你还可以给图片设置一个ID，标题，设定它的尺寸并使其成为一个链接。
Unresolved directive in images.adoc - include::example$image.adoc[tag=attr-co]-
定义块图像的标题，在渲染时该标题将显示在图像下方。
-
给块分配一个ID，并使图片成为链接。`link`属性也可以在块宏的属性列表内定义。
-
第一个位置属性，Sunset，是图像的替代文字。
-
第二和第三个位置属性分别定义了宽度和高度。
带属性列表的块级图像宏 结果显示如下。
Unresolved directive in images.adoc - include::example$image.adoc[tag=attr]
图形标题标签
当在块图像上定义标题时，图像标题将被自动添加一个标题标签（图）并编号。若要关闭图形标题标签和编号，请在文档头部取消设置 figure-caption 属性。
= 文档标题
图形标题内联图像宏
一个 内联图像 是在另一个元素的流中显示的，比如一个段落或侧边栏块。内联图像宏几乎与块图像宏完全相同，除了它的宏名称后面跟着一个单个的冒号（:）。
点击图片：play.png[] 来开始派对。 (1)
当你需要休息时，点击图片：pause.png[标题=暂停]。(2)-
在元素的流中，输入宏的名称和一个单冒号（
image:），后面跟着图像目标。用一对方括号（[]）完成宏的编写。 -
您可以在方括号内指定一个逗号分隔的属性列表，或者将其留空。
Unresolved directive in images.adoc - include::example$image.adoc[tag=inline]
Unresolved directive in images.adoc - include::partial$image-target.adoc[]
对于内联图像，可选标题将作为工具提示显示。