Jekyll Posts and Structure

After installing jekyll you’ll need to format your website directory in a way jekyll expects. Jekyll expects your website directory to be laid out like so:

my-awesome-site
├── assets
│   ├── css
│   │   └── style.css
│   └── js
├── _config.yml
├── _includes
├── index.html
├── _layouts
│   ├── default.html
│   └── post.html
├── _posts
│   ├── 2015-04-08-consectetur-elit.md
│   └── 2015-04-09-consectetur-elit-2.md
└── _site

assets This directory is not part of the standard jekyll structure. The assets directory represents any generic directory you happen to create in your root directory. Directories and files not properly formatted for jekyll will be left untouched for you to serve normally.

_config.yml Stores all the configuration data for the website.

_includes This folder is for partial views.

_layouts This folder is for the main templates your content will be inserted into. You can have different layouts for different pages or page sections.

_posts This folder contains your dynamic content/posts. the naming format is required to be YYYY-MM-DD-title.MARKUP. (example: 2015-08-07-my-first-blog.markdown)

_site This is where the generated site will be placed once Jekyll is done transforming it.

Posts are created using yml front matters and markdown language. They get processed, and the output is normal html.

Here’s some useful markdowns:

#H1
##H2
###H3
####H4
#####H5
######H6

*<i>italic</i>*, _<i>italic</i>_

**<b>Bold</b>**, __<b>Bold</b>__

[Link](http://www.example.com)

these will produce:

#H1

##H2

###H3

####H4

#####H5

######H6

italic, italic

Bold, Bold

Link

N.B.: There’s a list, you can find more here.