一篇GitBlog就是一个markdown文件，GitBlog使用解析markdown文件为html展示在网页上。所有的博客markdown文件必须放在blog文件夹里。后缀名只可以是xx.md或者xx.markdown。
在blog里新建文件helloworld.md，输入以下内容：
<!--
author: jockchou
date: 2015-07-30
title: Hello World!
tags: GitBlog
category: GitBlog
status: publish
summary: 你好！GitBlog
-->
你好！GitBlog
GitBlog是一个简单易用的Markdown博客系统，它不需要数据库，没有管理后台功能，更新博客只需要添加你写好的Markdown文件即可。
文件里头部的注释用来定义博客的属性，这是一个规定的写法，必须放在文件的头部，每个属性独占一行。再次访问首页，就能看到这篇新发的博客了。如果没显示，请清除writable/cache文件夹下的所有缓存文件试试看。
<!--
这里定义博客属性
-->
注意：markdown文件须采用utf8编码，如果出现乱码，请修改编码为utf8。
GitBlog目前针对博客定义了以下属性：
- author: 博客作者名称
- date: 博客时间，用于页面显示，通常来说你不需要填写这个字段，默认就是创建日期
- title: 博客标题
- tags: 博客里的标签，多个用逗号或空格分隔
- category: 博客分类，多个用逗号或空格分隔
- status: 博客状态，
draft表示草稿，GitBlog解析时会忽略草稿；publish表示发表状态，默认为publish - summary: 博客摘要信息
以上所有信息都是独占一行，暂不支持写在多行。
Gitblog新增了两个可选属性
- images:博客的图片集，这里可以定义博客用到的图片的地址
- head: 作者的头像地址
以上两个属性是可选的，主要是针对一些主题展示用的。
自动提取title，summary，images属性。Gitblog一个重要的功能，如果用户没有定义头部属性，Gitblog会自动解析博客内容，从中提取属性。提取第一个H1作为title，提取所有图片作为images，自动识别摘要信息summary。也就是说你可以不手动定义这三个字段，Gitblog会自动根据上述规则识别，不过还是推荐手动填写。
GitBlog中blog中的markdown文件可以放在子文件夹中。举个例子，假如你的helloword.md文件目录如下：
blog/hello/helloword.md
你在浏览器访问的对应地址应该是这样的：
http://jockchou.gitblog.cn/blog/hello/helloworld.html
GitBlog对blog中子文件夹的层级没有限制，但请尽量不要太深，一般2，3层就够了。如果你在本地编写博客，使用FTP工具上传markdown文件到blog目录，如果你熟悉使用Git，SVN类似工具，用它们来发表博客也是极好的。markdown文件的路径和文件名标识了博客的唯一性，改变路径或修改文件名将会导致博客的评论信息丢失。