文档格式说明

Markdown语法

http://jingxuan.io/markdown/

文档头部Front-matter

在文档头部添加一些关于文档的信息,语法是yaml(和json类似,需要注意每个字段的冒号后面必有空格,多个值的字段,每个值需要用’-‘开头,后面也必有空格),例如:
title题目
description描述(这个描述会在博客首页中显示)
tags标签(最好写上题目的类别,也可写上作者名)
categories分类(可根据week来分类,比如:week4),如果有多个分类则分类的顺序即为层次

详见:hexo文档

文档内容

题目

使用Markdown规定的题目写法来书写子题目,建议:
一级题目(如:# 题目 #)对应文章标题,也可省略
二级题目(如:## 子题目 ##) 对应文章子题目
题目可以自动生成目录,可在页面左下角查看。

图片

目前如果想上传图片可上传到自己的图床(如:imgur,七牛等),然后依照Markdown插入图片链接的格式添加到md文件中。以后可能会添加图片支持

关于评论功能

之后会添加多说评论框,方便交流

引用代码

在引入的代码块中加入自己的代码种类,这点可能和标准的Markdown语法不一样,例如:

引入java代码:

```java
System.out.println(“Hello world!”);
```

引入python代码:

```python
print ‘Hello world!’
```

总体示例

例如:

---
title: The title of the article
description: “Abstract of the article should be displayed in the main page. Must be quoted by ""
tags:
- stack
- pointer
categories:
- week4
---
Welcome to [Hexo](https://hexo.io/)! This is your very first post. Check [documentation](https://hexo.io/docs/) for more info. If you get any problems when using Hexo, you can find the answer in [troubleshooting](https://hexo.io/docs/troubleshooting.html) or you can ask me on [GitHub](https://github.com/hexojs/hexo/issues).

## Quick Start

### Create a new post

``` bash
\$ hexo new “My New Post”
```

More info: [Writing](https://hexo.io/docs/writing.html)

### Run server

``` bash
\$ hexo server
```

More info: [Server](https://hexo.io/docs/server.html)

### Generate static files

``` bash $ hexo generate ```

More info: [Generating](https://hexo.io/docs/generating.html)

### Deploy to remote sites

``` bash $ hexo deploy ```

More info:[Deployment](https://hexo.io/docs/deployment.html)

文章目录
  1. 1. Markdown语法
  2. 2. 文档头部Front-matter
  3. 3. 文档内容
    1. 3.1. 题目
    2. 3.2. 图片
    3. 3.3. 关于评论功能
    4. 3.4. 引用代码
  4. 4. 总体示例