Images

Images live in an images/ folder beside the articles of that month:

content/2026/07/
├── building-romyq.md
├── rust-career-path.md
└── images/
    ├── cover.webp
    ├── architecture.png
    └── demo.gif

Uploading on GitHub

Navigate to the month folder (e.g. content/2026/07/), click Add file → Upload files, and drop the images in. If the images/ folder does not exist yet, upload from inside the month folder and GitHub will keep the paths when you drag a folder in — or create a file named images/.gitkeep first to create the folder.

Referencing images

In the article, use a plain relative path:

![Architecture diagram](images/architecture.png)

The build resolves it to the deployed location (/2026/07/images/architecture.png) everywhere the article appears — the page itself, the RSS feed, everything. ./images/... works too.

The alt text (inside ![...]) matters: write what the image shows.

Cover images

Set a cover in frontmatter with the same relative style:

cover: ./images/cover.webp

The cover shows at the top of the article, on its homepage card, and becomes the image used when the link is shared on social media (OpenGraph/Twitter card). A wide image around 1200×630 works best.

Practical tips

• Prefer .webp for photos and screenshots — much smaller than PNG at the same quality.
• Keep images under ~300 KB where you can; every reader downloads them.
• Images are shared per month, so several articles in 2026/07/ can reference the same images/ folder.