Numbering

The .numbering function sets the global numbering format of the document. When a numbering format is set, counters are displayed next to:

• Headings and table of contents entries
• Figures
• Tables
• Custom elements (.numbered)

The configuration is represented by a Dictionary:

.numbering
  - headings: <format>
  - figures: <format>
  - tables: <format>

If a key is missing, its numbering is disabled.

Each format parameter accepts either none or a string where each character represents either a counter or a fixed symbol:

• 1 for decimal (1, 2, 3, ...)
• a for lowercase latin alphabet (a, b, c, ...)
• A for uppercase latin alphabet (A, B, C, ...)
• i for lowercase roman numerals (i, ii, iii, ...)
• I for uppercase roman numerals (I, II, III, ...)
• Any other character is a fixed symbol

The default numbering format, if unspecified, is:

• For paged documents (can be disabled via .nonumbering):

  • 1.1.1 for headings;
  • 1.1 for figures and tables.

• None for other documents

Headings

.numbering
  - headings: 1.A.a

# Title    <!--   1   -->
## Title   <!--  1.A  -->
### Title  <!-- 1.A.a -->
### Title  <!-- 1.A.b -->
#### Title <!-- None  -->
## Title   <!--  1.B  -->
# Title    <!--   2   -->
## Title   <!--  2.A  -->

 

Figures

Figures are numbered only if they feature a caption, which may also be empty.

.numbering
  - headings: 1.A.a
  - figures: 1.1

# Title

![Logo](quarkdown-icon.svg "The Quarkdown icon")

## Title

![Logo](quarkdown-icon.svg "")

# Title

![Logo](quarkdown-icon.svg "")

 

When numbering figures and tables, the amount of symbols in the format dictates the rules which cause the counters to reset.
The previous example, run with figures:{1}, results in the following:

Tables

Tables are numbered only if they feature a caption, which may also be empty.

.numbering
  - headings: 1.A.a
  - tables: 1.1

# Title

|           | Age | Favorite food |
|-----------|-----|---------------|
| **Anne**  | 24  | Hamburger     |
| **Lucas** | 19  | Pizza         |
| **Joe**   | 32  | Sushi         |
"Study results."

## Title

|           | Age | Favorite food |
|-----------|-----|---------------|
| **Anne**  | 24  | Hamburger     |
| **Lucas** | 19  | Pizza         |
| **Joe**   | 32  | Sushi         |
""

# Title

|           | Age | Favorite food |
|-----------|-----|---------------|
| **Anne**  | 24  | Hamburger     |
| **Lucas** | 19  | Pizza         |
| **Joe**   | 32  | Sushi         |
""

 

Custom numbered elements

Via .numbered. to do...

Localization

The localized name of the labeled element appear in captions if .doclang is set and the locale is supported.
For instance Figure and Table for the English locale, Figura and Tabella for Italian.

 

Themes

Layout themes affect the way numbers are displayed:

minimal theme