Markdown Console is a Jekyll theme, made with GitHub Pages in mind. You can preview the theme to see what it looks like, or even use it today.
The default layout includes a header and footer. See an example
The minimal layout is just the content. See an example
Markdown Console will respect the following variables, if set in your site's _config.yml
:
title: [The title of your site]
description: [A short description of your site's purpose]
Additionally, you may choose to set the following optional variables:
google_analytics: [Your Google Analytics tracking ID]
If you'd like to add your own custom styles:
- Create a file called
/assets/css/style.scss
in your site - Add the following content to the top of the file, exactly as shown:
--- --- @import "{{ site.theme }}";
- Add any custom CSS (or Sass, including imports) you'd like immediately after the
@import
line
If you'd like to change the theme's HTML layout:
- Copy the original template from the theme's repository
(Pro-tip: click "raw" to make copying easier) - Create a file called
/_layouts/default.html
in your site - Paste the default layout content copied in the first step
- Customize the layout as you'd like
See the open issues for a list of proposed features (and known issues).
WIP - as to not completely copypasta the Hacker readme ๐
Interested in contributing to this theme? This theme is an open source project, built one contribution at a time by users like you. See the CONTRIBUTING file for instructions on how to contribute.
If you'd like to preview the theme locally (for example, in the process of proposing a change):
- Clone down the theme's repository (
git clone https://github.com/MyNameIsCosmo/jekyll-theme-markdown-console
) cd
into the theme's directory- Run
sudo ./test_site.sh
- Visit
localhost:4000
in your browser to preview the theme