Skip to content
New to Sumi? Read the introduction.
Sumi
On this page

Images#

Images use standard Markdown. Paths are relative to the page, so the image works in your editor, on GitHub and on the site.

![The Sumi mark](../../assets/sumi-mark.svg)

Figures#

Add {caption="…"} on the line after an image to turn it into a figure:

![The Sumi mark](../../assets/sumi-mark.svg)
{caption="The Sumi mark: an ink stroke and a vermilion seal."}
The Sumi mark
The Sumi mark: an ink stroke and a vermilion seal.

Zoom#

Click an image in the content to view it full-screen; press Esc or click again to close. Images inside links and cards are not zoomable. To opt an image out, give it the no-zoom class:

![Diagram](flow.png){.no-zoom}

Light and dark variants#

Append #only-light or #only-dark to an image URL to show it in one colour scheme only:

![Architecture](arch-light.png#only-light)
![Architecture](arch-dark.png#only-dark)

Size and placement#

With attr_list, set the width or float an image:

![Logo](logo.png){width="120"}
![Screenshot](shot.png){.left width="320"}

Note

Images are lazy-loaded. Give large images explicit width and height attributes to avoid layout shift.

Esc
↵ to open ↑↓ to move Esc to close
Keyboard shortcuts
Ctrl K /
Open search and commands
t
Toggle dark mode
[ ]
Previous / next page
j k
Previous / next heading
?
Show this help