What's the best way to embed pictures in GitHub README files?

Yeah, storing images directly in your repo is definitely the way to go for keeping everything self-contained. I use a dedicated folder structure and reference them with standard markdown syntax like everyone else mentioned. But here’s what I’ve learned from managing bigger repos - don’t just throw everything into one images folder. Organize by feature or section once your project gets complex. GitHub’s CDN handles repo assets really well, so you won’t have loading issues. The big mistake I made early on was committing massive uncompressed images and then having to clean up git history later. Always check your file sizes before committing, especially screenshots from high-res displays.