Welcome to GitHub Pages.

This automatic page generator is the easiest way to create beautiful pages for all of your projects. Author your page content here using GitHub Flavored Markdown, select a template crafted by a designer, and publish. After your page is generated, you can check out the new master branch locally. If you’re using GitHub Desktop, simply sync your repository and you’ll see the new branch.

Latest posts

• Something New.
• Example Post

GitHub Pages Generator

If you’re seeing this you probably used the GitHub Pages Generator. This means you have a bunch of useful dev tools built in, and your local. You can start developing your site, with compilation of stylesheets, javascript and image minification handled automatically. Just type npm start (which you probably did just to see this page). When you’re ready to push your work up to GitHub Pages simply commit your work then run npm run deploy which will test your build, increment the version, and push the new work up to GitHub.

For more information see the README.

Creating pages manually

If you prefer to not use the automatic generator, push a branch named master to your repository to create a page manually. In addition to supporting regular HTML content, GitHub Pages support Jekyll, a simple, blog aware static site generator. Jekyll makes it easy to create site-wide headers and footers without having to copy them across every page. It also offers intelligent blog support and other advanced templating features.

Authors and Contributors

You can @mention a GitHub username to generate a link to their profile. The resulting <a> element will link to the contributor’s GitHub Profile. For example: In 2007, Chris Wanstrath (@defunkt), PJ Hyett (@pjhyett), and Tom Preston-Werner (@mojombo) founded GitHub.

Plugins and additional functionality

GitHub Pages supports a number of Jekyll plugins which are one by default in the GitHub Pages Generator version of the site. They add some great functionality. Read more about them.

• jekyll-mentions - the previous mentioned @mention support
• jemoji - use GitHub flavored emoji shorthand, like :+1:
• jekyll-redirect-from - use redirect_from and redirect_to in your frontmatter for easy page redirects
• jekyll-sitemap - automatically generate a sitemap.xml
• jekyll-feed - automatically generate a feed.xml
• jekyll-seo-tag - provides a bunch of SEO metadata and opengraph tags
• jekyll-paginate - paginate your results!
• jekyll-gist - specify a gist in your page or post with {% gist parkr/c08ee0f2726fd0e3909d %}
• jekyll-github-metadata - provides all the site.github contextual information that you get on GitHub in your local dev.

Support or Contact

Having trouble with Pages? Check out our documentation or contact support and we’ll help you sort it out.