Caption position

The .captionposition ^{docs ↗} function sets the global position of captions relative to the elements they describe.

This applies to:

• Figures
  • Figure Markdown extension
  • .figure
  • Mermaid diagrams and derivatives such as XY charts
• Tables
  • Table caption Markdown extension
  • Tables from CSV
• Code blocks
  • Code caption Markdown extension
  • .code

The primary parameter, called default, sets the global style for all captioned elements. Additional parameters figures, tables, and code override the default position for those specific element types.

Each parameter is optional and accepts top or bottom values. Documents use .captionposition {bottom} by default.

Example 1

.captionposition {bottom}

![Sky](sky.jpg "A nice sky.")

| Name | Favorite food | Favorite beverage |
|------|---------------|-------------------|
| John | Chicken       | Orange juice      |
| Jane | Pasta         | Iced tea          |
| Joe  | Sushi         | Beer              |
"Survey results."

Example 2

.captionposition {top}

Example 3

.captionposition {bottom} tables:{bottom}

Photo credits: Pixabay