Skip to content

Images

Typoteka gives images a few book-oriented behaviors on top of standard Markdown.

Figures and captions

A paragraph that contains only an image with alt text becomes a <figure>, using the alt text as its <figcaption>:

markdown
![A caption for the figure](images/photo.png)

Images without alt text stay inline in the surrounding text.

Outer images

Wrap an image in ::: outer to make it break out of the column flow and fill the full text-block width:

markdown
::: outer
![Caption text](images/photo.png)
:::

Outer bleed

::: outer bleed does the same as outer, and additionally bleeds the image off the page's outer edge — left on left (verso) pages, right on right (recto) pages. The outer side is resolved automatically after pagination, so you do not need to know which side a given image will land on:

markdown
::: outer bleed
![Caption text](images/photo.png)
:::

Notes

In the exported PDF, a bleeding image reaches the page trim.