6 unmodified lines
7+++
8
9images in zola sites on sublimated are handled automatically. when you push a folder containing images alongside your markdown, the build process rewrites image URLs to point to sublimated's CDN.
10
11## how it works
11## co-located image
12
131. you push files (markdown + images) to a zola folder via git
142. binary files (images, fonts, etc.) are stored in sublimated's CAS
153. zola builds the HTML from text files only (images aren't sent to the WASM builder)
164. after build, relative image paths in the output HTML are rewritten to `raw.sublimated.com` URLs
175. images are served from sublimated's edge network
13this image lives next to this markdown file as `sample.png`:
14
19## markdown images
15![sample gradient](sample.png)
16
21standard markdown image syntax works:
17the build step rewrites `sample.png` to a full `raw.sublimated.com` URL automatically.
18
23```markdown
24![alt text](photo.jpg)
25```
19## figure shortcode
20
27the build step resolves `photo.jpg` to the full CDN URL automatically.
21the figure shortcode adds a caption:
22
29## figure shortcode
23{{ figure(src="badge.png", alt="badge", caption="a small green badge image, co-located with this post") }}
24
31for images with captions, use the figure shortcode:
25## how it works
26
33```markdown
34{{/* figure(src="diagram.png", alt="architecture", caption="system overview") */}}
35```
271. you push files (markdown + images) to a zola folder via git
282. binary files (images, fonts, etc.) are stored in sublimated's CAS
293. zola builds the HTML from text files only (images aren't sent to the WASM builder)
304. after build, relative image paths in the output HTML are rewritten to `raw.sublimated.com` URLs
315. images are served from sublimated's edge network
32
33## supported formats
34
35any image format works — png, jpg, webp, avif, gif, svg. binary files are stored as-is in content-addressed storage and served with correct content-type headers.
40
41## external images
42
43you can also link to external images directly:
44
45```markdown
46![external](https://placekitten.com/400/300)
47```
48
49these are left as-is (no rewriting needed).