Images

Use images to support content and make pages easier to scan.

Where to put images#

• Put page and content images in assets/images/
• Reference them as /images/<file-name> in Markdown and templates
• Keep filenames descriptive and stable

Example from this project:

• assets/images/vincent-van-zalinge-e5VzJJDODbQ-unsplash.jpg

Use images in Markdown#

![A yellow and black bird sitting on top of a body of water](/images/vincent-van-zalinge-e5VzJJDODbQ-unsplash.jpg)

Use meaningful alt text that describes the image content, not just the filename.

Tips#

• Prefer modern, web-friendly formats and reasonable file sizes
• Avoid very large originals when a smaller version is enough
• Keep decorative icons in static/ when they are not content images

Learn more#