YARD actually supports whatever markup you choose, so if the markup supports images, I suspect it can. I've stuck with RDoc's markup since that's the default, but we could switch to something like Markdown if you don't mind.