文件元数据，如文档描述、关键词和自定义信息，可以分配给头部的属性。当转换成HTML时，这些属性的值将对应于HTML文档的`<head>`部分中包含的元素。

描述

您可以使用`description`属性来包含对文档的描述。

Unresolved directive in metadata.adoc - include::example$metadata.adoc[tag=desc-base]

  1. 如果文档的描述很长，你可以通过在每一行的末尾加上一个空格后跟反斜杠`\`来将属性的值分成多行。

当转换成HTML时，文档描述值被赋予HTML的`<meta>`元素。

HTML输出

Unresolved directive in metadata.adoc - include::example$metadata.adoc[tag=desc-html]

关键词

"`keywords` 属性包含了一个以逗号分隔的值列表，这些值被分配给 HTML 的 <meta> 元素。"

Unresolved directive in metadata.adoc - include::example$metadata.adoc[tag=key-base]
HTML输出

Unresolved directive in metadata.adoc - include::example$metadata.adoc[tag=key-html]

自定义元数据、样式和函数

您可以添加内容，如自定义元数据、样式表和脚本信息，通过docinfo（文档信息）文件到输出文档的头部。docinfo file部分详细说明了这些文件可以包含什么以及如何使用它们。