第二步：添加文章

本篇目录

• 本篇目录
• 说明
• 设置信息头
• 文章页内目录
• 撰写正文
  • 特殊字符
  • 标题
  • 语法高亮
• 参考

说明

文章在_post目录中，使用markdown语法，命名格式为 2019-05-07-add-post.md，文件名会被用来构成url，最好不要有中文，中文会使编码后的url非常长并且不美观。

设置信息头

在.md文件的开通设置信息头，指定布局模版，填写标题、作者、频道、标签，设置封面、关键字、描述信息等：

---
layout: default
title: "第二步：添加文章"
author: 李佶澳
date: "2019-05-07 23:35:48 +0800"
last_modified_at: "2019-05-07 23:51:57 +0800"
categories: tutorial
tags: 使用手册
cover:
keywords: Jekyll静态模版,Jekyll文章
description:  "在_post/目录中，用markdown语法写文章，支持频道和标签的设置"
---

上面的信息头就是这个页面的信息头，封面图(cover)可以为空，其它信息都填写完整，否则会导致页面布局不美观，以及影响搜索引擎收录。譬如description会添加到页面的head标签中，以及文章列表页的标题下方。

文章页内目录

在信息下方加上下面的两行，会在页面顶部生成文章页面目录：

* auto-gen TOC:
{:toc}

撰写正文

正文是标准的Markdown语法，直接使用即可。

特殊字符

花括号是Jekyll使用的liquid语言的标记符，在文章中使用需要特殊处理。

行内用\进行转义，{{在.md文件中的写法是：

\{\{

预览块中显示{{，用下面的方式：

{% raw %}
    这里的花括号不会被jekyll解析。
{% endraw %}

预览块中显示raw，用下面的方式，定义一个变量作为左侧的语法符号：

{% assign openTag = '\{%' %} 
{{ openTag }} raw %}   
       {% raw %}
{{ openTag }} endraw %}

{%和%}的展示比较麻烦，它们是liquid的代码块边界，要将这两个字符串保存到变量中，然后用{{变量名}}解析出来：

{% assign lefttag= '\{%' %}
{% assign righttag= '%\}' %}

{{ lefttag }}和{{ righttag }}的展示比较麻烦...

标题

标题一共六个级别，正文中从第二个级别开始使用，第一个级别默认用于页面标题：

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

语法高亮

支持语法高亮，下面是yml文件高亮设置方法：

```yml
itemlist:
- apple: 1
- pare: 2
```

展示出来是这样的：

itemlist:
- apple: 1
- pare: 2

参考

1. Jekyll: Transform your plain text into static websites and blogs.

 系列教程  使用手册