Testing gist with images in subdirectory

README.md

Gist Image Embedding Experiment

Findings

Directories: BLOCKED

Gists have a server-side pre-receive hook that rejects pushes containing directories:

remote: Gist does not support directories.
remote: These are the directories that are causing problems:
remote: images

Flat images with relative paths: WORKS

![Red](red.png) renders correctly when the PNG is a sibling file in the gist.

GitHub resolves relative paths to the raw URL automatically:

red.png → https://gist.github.com/USER/HASH/raw/COMMIT/red.png

Images also render standalone

Each PNG file in the gist gets its own section with an inline preview - GitHub detects the file type and renders it as an image automatically.

Demo

Red:

Blue:

Green:

blue.png

green.png

red.png