When creating markdown docs on GitHub, the preview displays how GitHub flavored markdown would render it to HTML, however the live version on the site will be using Jekyll’s Ruby interpretation of markdown called “kramdown”. So write your stuff here first:
Then copy it and paste it into GitHub.