GitHub Gists

I finally took a few minutes to learn what gists are in GitHub. I understood the basic idea from encountering them all over the web, but I wanted to precisely know what they are.

Here are some essential aspects of gists, as I understand them:

  • each gist is a repository, with all that implies:

can be versioned and diff’ed

  • can be forked or cloned

  • a gist can be public or secret

secret doesn’t mean private; it means not searchable

  • however, its URL is discoverable and shareable

  • a gist can contain anything text-based, such as:

source code

  • Markdown and plain text

  • JSON, XML, and CSV data

  • Jupyter Notebooks

  • GeoJSON files (maps!)

  • more info: About gists

My recent motivation for learning to use gists was to embed sample code on this blog, like this:

Pretty convenient and simple!