Caption position

The .captionposition^[docs] function allows globally setting the position of captions, relative to the element they describe.

This applies to:

• Figures
  • Figure Markdown extension
  • .figure
  • Mermaid diagrams and derivatives (e.g. XY charts)
• Tables
  • Table caption Markdown extension
  • Tables from CSV

---

The function's primary parameter is called default, which sets the global style for all kinds of captioned elements.
Additional parameters figures and tables override the default position for those specific categories.

Each parameter is optional and accepts top/bottom values.
By default, documents use .captionposition {bottom}.

 

.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."

 

.captionposition {top}

 

.captionposition {bottom} tables:{bottom}

 

 

Photo credits: Pixabay