Preview your README as if it was on github
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
.gitignore
.rvmrc
Gemfile
Guardfile
MIT-LICENSE
README.md
Rakefile
TODO.md
guard-readme-on-github.gemspec

README.md

guard-readme-on-github

See how your README will look on GitHub without having to push!

Currently, it only handles markdown'ed READMEs titled "README.md" or "README.markdown" (case-insensitive).

Installation

Use bundler. This gem depends on guard, so make sure that's in your Gemfile as well:

Gemfile:

group :development do
  gem 'guard'
  gem 'guard-readme-on-github'
end

Then run:

bundle

Setup

As with any other guard plugin, use the init command:

[bundle exec] guard init # necessary only the first time you set up guard
[bundle exec] guard init readme-on-github

Usage

Make sure guard is running:

guard

Modify your README (or just touch the modified-at flag) and view it in your browser:

open /tmp/markdown-preview.html

Author