How To Use GitHub Gists For Publishing Articles
GitHub Gists may be used not only for code snippets sharing but as a publishing platform for your articles.
Features And Restrictions Of GitHub Gists
Each gist is a git repo with restrictions and features:
- You can't create folders in any branch of the repo.
- Each file in the master branch larger than 1MB risks to be truncated so you can't add zip archive to master. But you may keep additional large files at another branches which can't be viewed on the gist page.
- If you want to use images in your article but wish non-embedded images to be hidden on the gist page then you may keep them in non-master branch and reference by
./<id of your gist>/raw/<commit hash>/foobar.jpg.