1+++
2title = "images and assets"
3date = 2026-04-21
4description = "how images work in zola on sublimated"
5[taxonomies]
6tags = ["demo", "images"]
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
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
18
19## markdown images
20
21standard markdown image syntax works:
22
23```markdown
24
25```
26
27the build step resolves `photo.jpg` to the full CDN URL automatically.
28
29## figure shortcode
30
31for images with captions, use the figure shortcode:
32
33```markdown
34{{/* figure(src="diagram.png", alt="architecture", caption="system overview") */}}
35```
36
37## supported formats
38
39any 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
47```
48
49these are left as-is (no rewriting needed).