kennethrapp

GitSwag displays data from a Github account using Github’s public API. In order to avoid 
rate-limiting, it caches the JSON from the API locally, and refers to that whenever 
available. You can display a user profile, list of repositories, header for a single 
repository, preview files or gists.
<h3>Administration</h3>
In “GitSwag” under the settings tab, enter your github username, select the 
“update cache” checkbox and submit to change your username. Files under that 
username can be deleted by checking the box next to the file and submitting.
Any changes you make to your github repo won’t be reflected immediately by 
the plugin, you’ll have to manually delete the cache first.
<h3>Composer Updating</h3>
This plugin includes <a href="Composer" rel="nofollow ugc">http://getcomposer.org</a> and an autoloader to implement 
the <a href="Parsedown" rel="nofollow ugc">http://parsedown.org/</a> library.
To save a bit of space, composer.phar isn’t included with this plugin.
Parsedown is [https://github.com/erusev/parsedown/blob/master/LICENSE.txt](MIT licensed)
<h3>Shortcode</h3>
Display the profile of a single user 
[gitswag_user_view github_username=”username”]
Display a list of repos for a user 
[gitswag_repo_list github_username=”username”]
View data for a repository 
[gitswag_repo_view github_username=”username” github_repo=”reponame”]
Preview a file 
[gitswag_file_view github_username=”username” github_repo=”reponame” path=”path/to/” filename=”file.txt”]
List gists by a user 
[gitswag_gist_list github_username=”username”]
Preview a gist 
[gitswag_gist_view gist_id=”id”]
display the readme for a repo 
[gitswag_readme github_username=”username” github_repo=”reponame”]
<h3>Administration</h3>
Because the public github API is rate limited, this plugin will download and keep a cached 
version of the .json files and readme markdown from API calls locally, and will need to be deleted 
in the admin panel when a change needs to be reflected. You can select a file and submit to delete them.

GitSwag

Integrate various Github API-driven shortcodes into your pages.

Jason Stallings

ianmjones

olensmar

nlenkowski

Github README is a plugin that allows you to embed markdown from GitHub in a page or post using a simple shortcode.
Usage:
github_readme
This shortcode embeds the project’s readme.
[github_readme repo=”octalmage/Marknote”]
You can also trim lines from the top of the readme using the “trim” option:
[github_readme repo=”octalmage/Marknote” trim=”3″]
This is useful for removing titles since your page/post will most likely already have one.
github_markdown
This shortcode embeds any markdown file found in the repository.
[github_markdown repo=”octalmage/Marknote” file=”README.md”]
trim, branch, and cache (seconds to cache) also supported.
github_wikipage
This shortcode embeds pages from a project’s wiki.
[github_wikipage repo=”octalmage/Marknote” page=”Syntax”]
trim and cache also supported.

Github README

As described... it work fine and very well!

One suggestion: from the guide https://guides.github.com/features/mastering-markdown/ the relative images are resolved with absolute path on the github repository.

Very Good!

Easily embed GitHub READMEs in pages/posts.

GitSwag vs Github README