This revealed so much pain: [Wayback] gist include image in markdown in current directory – Google Search
I wished that – like in the past – it would work just like in a normal github hosted git repository: [Wayback/Archive] How do I display local image in markdown? – Stack Overflow.
The core problem is that though a gist underneath is a git repository, it is rendered in a way that is different than a github repository is rendered, and that way of rendering has changed over the years effectively making it difficult to embed a picture. When you do embed an image requires the uuid/guid of the raw image URL to be included in the markdown, unlike with a regular repository hosted on github.
That is so much pain that I decided to not host documentation in gists any more.
A bit of the pain:
- [Wayback/Archive] Adding Images to markdown files in Gist.markdown
- [Wayback/Archive] Is there an easy way to link image in a GIST ? showing the ways that worked and now work (only if you include the right uuid)
- [Wayback/Archive] github – Is it possible to make relative link to image in a markdown file in a gist? – Stack Overflow same as the above gist.
This is an example gist where I tried to host an image: [Wayback/Archive] Windows 7 with PowerShell v2 fails to upgrade to PowerShell v3 through chocolatey: You must provide a value expression on the right-hand side of the '-' operator.
That gist was prelude to my post Chocolatey on Windows 7: “You must provide a value expression on the right-hand side of the ‘-‘ operator.”.
–jeroen