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)