An example post

You’ll find this post in your _posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.

To add new posts, simply add a file in the _posts directory that follows the convention YYYY-MM-DD-name-of-post.ext and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Jekyll also offers powerful support for code snippets:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.

This is an example of post.

Post’s YAML

layout: post

This should NOT be changed.
title

The title of your article.
author

E.g. author: Lambda, default is the site’s author.
date

E.g. date: 2015-08-17 or data: 2015-08-17 15:06:10
categories

No blanks, one post to one category. E.g. categories: ["test"], categories: ["test-this"]
tags (optional)

You can specify one or more tags. E.g. tags: [jekyll, html].

mathjax (optional)

if you need enable mathjax: mathjax: true; otherwise mean disable.
update (optional)

E.g. update: 2015-05-02
comment (optional)

enable the comment. E.g. comment: true
published (optional)

true or false

Post’s Content

Include Liquid in markdown

All legal markdown syntax may be allowed.
Liquid synatax also should be allowed.

So, if you want to avoid syntax conflicts, you can use {% raw %}

(More liquid syntax, see Liquid-for-Designers)

Markdown

kramdown

Test

Some long sentence.¹ Other long sentence.

Link. ↩

This is a test