/

脚注

脚注让读者能够引用额外信息,而不会让主要内容变得杂乱。

紧凑脚注

Quarkdown 引入了紧凑的 [^label: definition] 语法,让你可以直接在引用点定义脚注。

示例 1

This is a footnote reference[^first: This is the definition.],
and another one[^second: This is another definition.].
脚注

具名脚注可以被多次引用。

示例 2

This is a footnote reference[^first: This is the definition],
and another one[^first].
脚注多引用

定义中可以包含行内格式。

示例 3

This is a footnote reference[^first: This is the **definition**.]
脚注格式

匿名脚注

当一个行内脚注不需要在其他地方被引用时,你可以省略标签来创建一个匿名脚注。

示例 4

This is a footnote reference[^: This is the definition.],
and another one[^: This is another definition.].

标准脚注

Quarkdown 也支持许多 Markdown 变体所提供的标准脚注语法。

这种方式较为冗长,但能让脚注引用与其定义干净地分离,减少正文中的杂乱。

This is a footnote reference[^1].

[^1]: This is the definition.

定义中也支持行内格式:

[^1]: This is the **definition**.

较长的定义可以跨越多行。缩进无关紧要:

[^1]: This is
      the definition.

当你有多个脚注时,请用至少一个空行来分隔各个定义:

This is a footnote reference[^first], and another one[^second].

[^first]: This is the definition.

[^second]: This is another definition.

允许对同一脚注标签进行多次引用,它们都指向同一个定义:

This is a footnote reference[^first], and another one[^first].

[^first]: This is the definition.

脚注标签可以是任意字符串,且定义可以出现在文档中的任何位置:

[^first]: This is the definition.

This is a footnote reference[^first], and another one[^second].

[^second]: This is another definition.

编号

脚注默认使用十进制数字编号,从 1 开始。要应用不同的编号样式(例如罗马数字),请使用 .numbering 函数。更多信息请参阅编号

示例 5

.numbering
    - footnotes: i
脚注罗马数字编号

脚注在子文档范围内按顺序递增编号。目前尚不支持页级编号。

显示

脚注的渲染方式因文档类型而异。更多信息请参阅文档类型