Hexo于Markdown语法的支持之基础篇

因为选择了Hexo来作为博客系统, 那必须学习Markdown语法的使用. 这篇如果是一些基础语法, 如果想看更高阶的内容, 请点击这里: Hexo于Markdown语法的支持之进阶篇

1.标题

代码如下:

# 大标题
## 二标题
### 三标题
#### 四标题
##### 五标题
###### 六标题

效果如下:

大标题

二标题

三标题

四标题

五标题
六标题

另外, 还可用 ‘=’和’-‘语法实现标题功能, 代码如下

大标题
=
二标题
-

实现效果如下

大标题
=
二标题
-

说明’=’和’-‘在Hexo中作为标题无法使用


2. 引用

代码如下:

>Do not go gentle into that good night. -Interstellar

效果如下:

Do not go gentle into that good night. -Interstellar

3. 列表

代码如下:

- 早上的任务
 + 起床
 + 刷牙
 + 洗脸
 + 吃饭
- 下午的任务
 + 逛街
 + 去商场
  * 买衣服
  * 买鞋子
   1. 买篮球鞋
   2. 买高跟鞋
   3. 买拖鞋
   4. 买棉鞋
  * 买裤子
 + 回家
- 晚上的任务
 + 吃饭
 + 睡觉

效果如下:

  • 早上的任务
    • 起床
    • 刷牙
    • 洗脸
    • 吃饭
  • 下午的任务
    • 逛街
    • 去商场
    • 买衣服
    • 买鞋子
      1. 买篮球鞋
      2. 买高跟鞋
      3. 买拖鞋
      4. 买棉鞋
    • 买裤子
    • 回家
  • 晚上的任务
    • 吃饭
    • 睡觉

由代码实现的效果可知, 最多只能实现两层列表, 即’-‘和’+’, 而第三个’‘被当作和’+’同级别处理, 用数字标号的有序列表可以正常显示
另外, *列表功能可以和引用功能复用
,代码如下:

> - 早餐的选择
>  1. Bacon
>  2. Waffle
>  3. Fruit
> - 午餐的选择
>  + 鱼香肉丝
>  + 宫保鸡丁
> - 晚餐的选择
>  * 饿着

效果如下:

  • 早餐的选择
    1. Bacon
    2. Waffle
    3. Fruit
  • 午餐的选择
    • 鱼香肉丝
    • 宫保鸡丁
  • 晚餐的选择
    • 饿着

4. 分割线

代码如下:

---
上面是一条分割线
……
上面是什么?

效果如下:


上面是一条分割线
……
上面是什么?

说明只有’—‘能实现分割线的效果

5. 链接, 图片和文档

链接功能

代码如下:

[知乎](http://www.zhihu.com)

效果如下:

知乎

图片功能

代码如下:

![知乎的Logo](http://www.ifanr.com/wp-content/uploads/2011/05/zhihu.jpg)

效果如下:

知乎的Logo

链接和图片的插入方法还可以用先插入’[]’,再通过另一个’[]’索引数字,在文章的最后提供索引地址的方法,代码如下:

[UBER][1]
![][2]

在文章的最后的索引地址代码是

[1]:http://www.uber.com
[2]:http://upload.news.cecb2b.com/2013/0823/1377257023871.jpg

效果如下:

UBER

6. 插入本地图片和文档

图片’temp_handbags.jpg’放入了’Hexo/source/image’
代码如下:

![](image/temp_handbags.jpg)

效果如下:

图片在首页显示正常, 而在post页面显示失败, 据Hexo的作者tommy351表示, 解决的方法需要将链接换成绝对路径.
用Google找了找解决方法, 发现一个可行的, 链接在此

###我总结的解决方法如下:

1. 安装

打开Git Shell, 在Hexo根目录下, 输入如下代码

$ npm install hexo-tag-asset-res --save

2. 修改

打开Hexo根目录, 找到_config.yml文件, 用任何一个文本编辑器打开, 找到如下代码

post_asset_folder: false

false 改成 true

3. 使用

至此, 在Hexo中用 Hexo new “Post-Name” 命令会生成默认的 Post-Name.md 文件, 还会额外生成名为 Post-Name 的文件夹.
将需要从本地上传到Github的图片, 假设为 photo.jpg , 或文档, 假设为 doc.pdf, 放到这个文件夹里, 然后在 Post-Name.md 文件中按如下方式引用:

就能够实现图片的正确显示和本地链接的正确显示了.
注: doc-name 是本地链接的显示名称, 可以改成任何想要的.

至此, 一些基本的Markdown的语法在Hexo的实现都测试过了, 如果想看更高阶的内容, 请点击这里: Hexo于Markdown语法的支持之进阶篇