- You want to create an "about me" page from a single markdown file and host it under a custom domain name.
- You want to create a single-page website that's mostly text, like Know Your Company.
- You want to share a single markdown file and tried GitHub Gist (example), but would like something nicer-looking.
- You want something like GitHub's automatic page generator for a non-code repository.
This page itself is built with Solo. It's generated from this markdown file.
First, install Jekyll. Then download Solo from its GitHub Repository. Start Jekyll and you should see this page up and running.
- Edit
_config.ymlto change the site's title and description. - Edit
_includes/head.htmlto add custom code to<head>. - Edit
_includes/scripts.htmlto add custom code before</body>. - Edit
CNAMEto host on a custom domain. - Edit
README.mdbefore pushing your code.
Wthin index.md, do not use <h1> tags - <h1> is reserved for the site title.
Solo supports lists, <hr>s, <table>s,
blockquotes, and...
<pre>code blocks with syntax highlighting.</pre>