footnote
Element
Element functions can be customized with set
and show
rules.
set
and show
rules.A footnote.
Includes additional remarks and references on the same page with footnotes. A footnote will insert a superscript number that links to the note at the bottom of the page. Notes are numbered sequentially throughout your document and can break across multiple pages.
To customize the appearance of the entry in the footnote listing, see
footnote.entry
. The footnote itself is realized as a
normal superscript, so you can use a set rule on the super
function to
customize it. You can also apply a show rule to customize only the footnote
marker (superscript number) in the running text.
Example
Check the docs for more details.
#footnote[https://typst.app/docs]
The footnote automatically attaches itself to the preceding word, even if
there is a space before it in the markup. To force space, you can use the
string #" "
or explicit horizontal spacing.
By giving a label to a footnote, you can have multiple references to it.
You can edit Typst documents online.
#footnote[https://typst.app/app] <fn>
Checkout Typst's website. @fn
And the online app. #footnote(<fn>)
Note: Set and show rules in the scope where footnote
is called may not
apply to the footnote's content. See here for more information.
Parameters
Parameters are the inputs to a function. They are specified in parentheses after the function name.
numbering
How to number footnotes.
By default, the footnote numbering continues throughout your document. If you prefer per-page footnote numbering, you can reset the footnote counter in the page header. In the future, there might be a simpler way to achieve this.
Default:"1"
View example
#set footnote(numbering: "*")
Footnotes:
#footnote[Star],
#footnote[Dagger]
body
The content to put into the footnote. Can also be the label of another footnote this one should point to.
Definitions
Functions and types and can have associated definitions. These are accessed by specifying the function or type, followed by a period, and then the definition's name.
entry
An entry in a footnote list.
This function is not intended to be called directly. Instead, it is used in set and show rules to customize footnote listings.
View example
#show footnote.entry: set text(red)
My footnote listing
#footnote[It's down here]
has red text!
Note: Footnote entry properties must be uniform across each page run (a page run is a sequence of pages without an explicit pagebreak in between). For this reason, set and show rules for footnote entries should be defined before any page content, typically at the very start of the document.
note
The footnote for this entry. It's location can be used to determine the footnote counter state.
View example
#show footnote.entry: it => {
let loc = it.note.location()
numbering(
"1: ",
..counter(footnote).at(loc),
)
it.note.body
}
Customized #footnote[Hello]
listing #footnote[World! 🌏]
separator
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The separator between the document body and the footnote listing.
Default:line(length: 30% + 0pt, stroke: 0.5pt)
View example
#set footnote.entry(
separator: repeat[.]
)
Testing a different separator.
#footnote[
Unconventional, but maybe
not that bad?
]
clearance
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The amount of clearance between the document body and the separator.
Default:1em
View example
#set footnote.entry(clearance: 3em)
Footnotes also need ...
#footnote[
... some space to breathe.
]
gap
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The gap between footnote entries.
Default:0.5em
View example
#set footnote.entry(gap: 0.8em)
Footnotes:
#footnote[Spaced],
#footnote[Apart]
indent
Settable
Settable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The indent of each footnote entry.
Default:1em
View example
#set footnote.entry(indent: 0em)
Footnotes:
#footnote[No],
#footnote[Indent]