How can one display images side by side in a GitHub README.md?

The easiest way I can think of solving this is using the tables included in GitHub’s flavored markdown. To your specific example it would look something like this: Solarized dark | Solarized Ocean :————————-:|:————————-: ![](https://…Dark.png) | ![](https://…Ocean.png) This creates a table with Solarized Dark and Ocean as headers and then contains the images in the … Read more

Is there a way to add a gif to a Markdown file?

Showing gifs need two things 1- Use this syntax as in these examples ![Alt Text](https://media.giphy.com/media/vFKqnCdLPNOKc/giphy.gif) Yields: 2- The image url must end with gif 3- For posterity: if the .gif link above ever goes bad, you will not see the image and instead see the alt-text and URL, like this: 4- for resizing the gif … Read more

Is there a command line utility for rendering GitHub flavored Markdown?

I wrote a small CLI in Python and added GFM support. It’s called Grip (Github Readme Instant Preview). Install it with: $ pip install grip And to use it, simply: $ grip Then visit localhost:5000 to view the readme.md file at that location. You can also specify your own file: $ grip CHANGES.md And change … Read more

GitHub relative link in Markdown file

Update 30th, January 2013, 16 months later: GitHub Blog Post Relative links in markup files: Starting today, GitHub supports relative links in markup files. Now you can link directly between different documentation files, whether you view the documentation on GitHub itself, or locally, using a different markup renderer. You want examples of link definitions and … Read more