@iamerwin, To create responsive images, you need to add a few things to the image definition:
Unfortunately, as the Grav docs say about using 'derivatives()':
For the moment it does not work inside markdown, only in your twig files.
However it does work in Twig and Twig can be embedded inside a Markdown file. For example:
02.typography/default.md
---
title: Typography
process:
twig: true <-- Tell Grav to process Twig inside Markdown
---
{{ page.media['my-image.jpg'].derivatives(320,1600,300).sizes('(max-width:1000px) 100vw, 50vw').html() }}
generated html (formatted)
<img alt=""
src="/user/pages/02.typography/my-image.jpg"
srcset="
/images/1/e/4/7/2/1e472b7a438...-my-image320w.jpeg 320w,
/images/e/b/f/5/8/ebf58aac161...-my-image620w.jpeg 620w,
/images/5/5/e/e/1/55ee1375564...-my-image920w.jpeg 920w,
/user/pages/02.typography/my-image.jpg 1200w"
sizes="(max-width:1000px) 100vw, 50vw"
>
Now the browser can choose the optimal image size.
Off course you'll have to play around a bit to suit your own needs.
Hope this helps!