Github-hosted markdown blog Steps fork repository in the settings, activate Github Pages using /docs as the source start writing markdown content in the pages folder use ? suffix for local links to other pages eg ?page2 use docs/assets to store assets Serve index.html locally to display markdown dynamically while writing Ready to build? run node utils/build.js to generate html into /docs folder Custom domain? under Github Pages settings, add custom url and enforce HTTPS Structure index.html assets css main.css images favicon.png pages index.md test.md utils lib checkbox.js Marked.js Highlight.js build.js dev.js