使用元数据块,可以为网页添加头部元素(<head>
中的元素)和页眉 (<header>
)。元数据块有两种写法:
使用元数据块时,必须设置 --standalone
(-s
)选项。否则,元数据块中的内容不会输出到 HTML 中。
使用百分号表示法输入的元数据块必须放在 Markdown 文件的开头,而且元数据块的前面不能有任何空行。
百分号表示法的写法如下:
使用百分号表示法时,标题、作者和日期的先后顺序是固定的,不能互换。但是,你仍然可以只输入其中的一项或两项。比如,只输入标题和作者的写法如下:
如果只想输入后面的项,必须使用以百分号开头的空行来替代前面的项。比如,只输入作者时的写法如下:
如果省略了以百分号开头的空行,“作者”会被 Pandoc 作为元数据块中的标题文本进行编译。
元数据块中的标题可以跨行,但后续行必须以空格开头。
在元数据块中可以输入多名作者,使用以下三种写法之一即可:
元数据块中的日期不允许跨行。
使用 YAML 表示法输入的元数据块可以放在 Markdown 文件的任何位置。
YAML 元数据块有以下两种写法:
如果 YAML 元数据块没有位于 Markdown 文件的开头,使用空行分隔元数据块与正文。