You can use the editor on GitHub to maintain and preview the content of Markdown formatted posts.
Whenever a change is merged to this repository, GitHub Pages will run Jekyll to rebuild the blog, from the content in the Markdown formatted posts and pages.
| Path | Description |
|---|---|
_layouts |
Contains HTML layout template for rendering markdown content |
_posts |
Contains markdown formatted blog posts, see #posts for more information |
assets/css |
CSS overrides for the theme; this will be compiled automatically |
CNAME |
Custom domain for GitHub Pages |
_config.yml |
Jekyll configuration file |
docker-compose.yml |
Docker Compose setup for running locally |
All posts are located in the _posts directory using Markdown and Jekyll Front Matter. You can just look at existing blog posts to see the structure, but a simple example looks like this:
---
layout: post
title: The Hacker Mindset
---
Content goes here!For running the blog locally for development purposes you only need Docker and Docker Compose installed. Clone the repository and run the following command from the repo root:
$ docker up
The blog will be accessible over port :4000 and reload automatically on code changes.
Markdown is a lightweight and easy-to-use syntax for styling your writing. It includes conventions for
Syntax highlighted code block
# Header 1
## Header 2
### Header 3
- Bulleted
- List
1. Numbered
2. List
**Bold** and _Italic_ and `Code` text
[Link](url) and For more details see GitHub Flavored Markdown.
This Blog uses the layout and styles from the Jekyll theme you have selected in your the Jekyll _config.yml configuration file.
Having trouble with Pages? Check out our documentation or open an issue and we’ll help you sort it out.