How to include markdown (.md) files inside html files
<p>Suppose I have a <code>README.md</code> file in a github repository. I am then making a website all about this repository that I will host using <code>gh-pages</code>.</p>

<p>What I want is to have a section of my <code>index.html</code> file that gets its content from my <code>README.md</code> file. This way, only one file needs to be updated.</p>

<p>I imagine that the markdown file will first need to be converted to html, and that html can then be put into another html file. </p>

<p>I have looked into <a href="http://www.html5rocks.com/en/tutorials/webcomponents/imports/" rel="noreferrer">HTML5 Imports</a>, but they are only currently supported in Chrome. Using a separate <code>.js</code> file with <code>document.write()</code> could be useful, but is there a simple, clean way?</p>