經(jīng)過(guò)一段時(shí)間的折騰終于用 Hexo + GitHub 搭建起了一個(gè)個(gè)人博客站點(diǎn)吩坝，第一時(shí)間邊學(xué)邊寫控轿，弄出了這第一篇博客凤瘦，心里甚是歡喜。

Hexo是一款“快速案铺、簡(jiǎn)潔且高效的博客框架”蔬芥，支持 Markdown 的所有功能。所以，寫出一篇博客必須學(xué)習(xí) Hexo 和 Markdown 的使用規(guī)則笔诵。

配置文件命名規(guī)則和路由地址

Hexo 默認(rèn)以標(biāo)題作為文件名稱返吻，可以通過(guò) Hexo 的配置文件 _config.yml 中的 new_post_name 參數(shù)來(lái)改變默認(rèn)的文件名稱，例如：

    new_post_name: :year-:month-:day-:title.md

當(dāng)創(chuàng)建博客時(shí)乎婿，就會(huì)以這種格式生成Markdown文件测僵，如這篇博客的文件名就生成 2017-01-13-hexo-blog.md 這種形式。其中相關(guān)變量說(shuō)明如下表：

配置瀏覽器地址欄中的URL褒侧。同樣在 Hexo 的配置文件 _config.yml 中, 配置 permalink 屬性 良风，例如：

    permalink: /blog/:year/:month/:day/:title/

當(dāng)在地址欄訪問(wèn)時(shí)，就會(huì)如下方式呈現(xiàn)出來(lái)：

    http://localhost:4000/blog/2017/01/13/hexo-blog/

特殊字符

在寫博客時(shí),一定注意不要寫這些字符,如果要寫,就進(jìn)行轉(zhuǎn)義
有些人可能說(shuō)可以使用反斜杠 \ 來(lái)處理,我這里不建議,因?yàn)槲沂褂玫臅r(shí)候沒(méi)有解決問(wèn)題闷供。
下面是比較常見(jiàn)的幾個(gè):

! ! — 驚嘆號(hào)Exclamation mark 

” " " 雙引號(hào)Quotation mark 

# # — 數(shù)字標(biāo)志Number sign 

$ $ — 美元標(biāo)志Dollar sign 

% % — 百分號(hào)Percent sign 

& & & Ampersand 

‘ ' — 單引號(hào)Apostrophe 

( ( — 小括號(hào)左邊部分Left parenthesis 

) ) — 小括號(hào)右邊部分Right parenthesis 

* * — 星號(hào)Asterisk 

+ + — 加號(hào)Plus sign 

< &#60; &lt; 小于號(hào)Less than 

= &#61; — 等于符號(hào)Equals sign 

> &#62; &gt; 大于號(hào)Greater than 

? &#63; — 問(wèn)號(hào)Question mark 

@ &#64; — Commercial at 

[ &#91; --- 中括號(hào)左邊部分Left square bracket 

\ &#92; --- 反斜杠Reverse solidus (backslash) 

] &#93; — 中括號(hào)右邊部分Right square bracket 

{ &#123; — 大括號(hào)左邊部分Left curly brace 

| &#124; — 豎線Vertical bar 

} &#125; — 大括號(hào)右邊部分Right curly brace 

特別注意的是小括號(hào) ( ) 大括號(hào) { } ,如果不小心寫了,你執(zhí)行hexo s –debug可能報(bào)一些莫名其妙的錯(cuò)誤!

創(chuàng)建博客

在命令行中用如下命令創(chuàng)建一篇新的文章

   $ hexo new [layout] <title>

可以用 publish 命令將草稿移動(dòng)到 source/_posts 文件夾下

   $ hexo publish [layout] <title>

寫作

經(jīng)過(guò)上面上面一系列的準(zhǔn)備工作，現(xiàn)在差不多就可以安心的寫作了歪脏。打開(kāi) source/_posts 文件夾下剛創(chuàng)建的 Markdown 文件疑俭，你會(huì)發(fā)現(xiàn)有如下內(nèi)容：

    ---
    title: hexo-blog
    date: 2017-01-13 16:07:32
    tags: 
    ---

注意，這里的 title 是可以隨便改的唾糯，當(dāng)然了 date 也是可以改怠硼，不過(guò)沒(méi)有改的必要；這里要說(shuō)一下 tags 這個(gè)屬性移怯，如果需要配置多個(gè)有兩種方式：

    tags: [tag1, tag2, tag3]

    tags:
        - tag1
        - tag2
        - tag3

Hexo 是支持 Markdown 的所有功能的香璃，所以，下面去學(xué)習(xí)一下 Markdown 的語(yǔ)法規(guī)范

斜體和粗體

寫法：

    *斜體文本*    _斜體文本_
    **粗體文本**    __粗體文本__
    ***粗斜體文本***    ___粗斜體文本___

效果：
斜體文本 斜體文本
粗體文本 粗體文本
粗斜體文本 粗斜體文本

分級(jí)標(biāo)題

寫法：

# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題

超鏈接

寫法：

    行內(nèi)形式：[我的博客](https://Lee981265.github.io/)
    參考形式：[我的博客][1]舟误，有一個(gè)很好的平臺(tái)-[簡(jiǎn)書][2].
    這個(gè)鏈接用 yahoo 作為網(wǎng)址變量 [Yahoo!][yahoo].
    [yahoo]: http://www.yahoo.com/
    [1]:https://Lee981265.github.io/
    [2]:http://www.reibang.com/
    自動(dòng)鏈接：我的博客地址<https://Lee981265.github.io/>

效果：
行內(nèi)形式：我的博客
參考形式：[我的博客][1]葡秒，有一個(gè)很好的平臺(tái)-[簡(jiǎn)書][2]
[1]:https://Lee981265.github.io/
[2]:http://www.reibang.com/
自動(dòng)鏈接：我的博客地址https://Lee981265.github.io/

列表

無(wú)序列表：

寫法：

* 無(wú)序列表項(xiàng)1
+ 無(wú)序列表項(xiàng)2
- 無(wú)序列表項(xiàng)3

效果：

• 無(wú)序列表項(xiàng)1

• 無(wú)序列表項(xiàng)2

• 無(wú)序列表項(xiàng)3

有序列表

寫法：

1. 有序列表項(xiàng)1
2. 有序列表項(xiàng)2
3. 有序列表項(xiàng)3

效果

1. 有序列表項(xiàng)1
2. 有序列表項(xiàng)2
3. 有序列表項(xiàng)3

列表嵌套

1. 列出所有元素：
    - 無(wú)序列表元素 A
        1. 元素 A 的有序子列表
    - 前面加四個(gè)空格
2. 列表里的多段換行：
    前面必須加四個(gè)空格，
    這樣換行嵌溢，整體的格式不會(huì)亂
3. 列表里引用：

    > 前面空一行
    > 仍然需要在 >  前面加四個(gè)空格

1. 列出所有元素：

   • 無(wú)序列表元素 A
     1. 元素 A 的有序子列表
   • 前面加四個(gè)空格

2. 列表里的多段換行：
   前面必須加四個(gè)空格眯牧，
   這樣換行，整體的格式不會(huì)亂

3. 列表里引用：

   前面空一行
   仍然需要在 > 前面加四個(gè)空格

引用

1. 普通引用

> 引用文本前使用 [大于號(hào)+空格]
> 折行可以不加赖草，新起一行都要加上哦

2. 引用里嵌套引用

> 最外層引用
> > 多一個(gè) > 嵌套一層引用
> > > 可以嵌套很多層

3. 引用里嵌套列表

> - 這是引用里嵌套的一個(gè)列表
> - 還可以有子列表
>     * 子列表需要從 - 之后延后四個(gè)空格開(kāi)始

插入圖片

在 Hexo 中插入圖片学少，首先需要將圖片放在 source/img/ 文件夾下，然后如下方式進(jìn)行插入

  ![這是圖片說(shuō)明](/img/Leebolg.png)

  這個(gè)鏈接用 1 作為網(wǎng)址變量 [ Google] [ 1].
  然后在文檔的結(jié)尾位變量賦值(網(wǎng)址)

    [1]: http: //www.google.com/logo.png
    也可以使用 HTML 的圖片語(yǔ)法來(lái)自定義圖片的寬高大小
    <img src="https://lee981265.github.io/img/Leebolg.png" width="240" height="275">

效果圖如下：

效果圖

效果圖

{% asset_img img/Leebolg.png.jpg 這是一個(gè)新的博客的圖片的說(shuō)明老版本指出3.0以下 %}

換行

如果另起一行秧骑，只需在當(dāng)前行結(jié)尾加 2 個(gè)空格

在當(dāng)前行的結(jié)尾加 2 個(gè)空格  
這行就會(huì)新起一行
如果是要起一個(gè)新段落版确，只需要空出一行即可扣囊。

分隔符

如果你有寫分割線的習(xí)慣，可以新起一行輸入三個(gè)減號(hào)-绒疗。當(dāng)前后都有段落時(shí)侵歇，請(qǐng)空出一行：

前面的段落

---

后面的段落

小型文本

Markdown語(yǔ)法：

<small>文本內(nèi)容</small>

預(yù)覽效果：
我是正常文字
<small>我是小型文字</small>

注釋

用html的注釋，好像只有這樣吓蘑？

<!-- 注釋 -->

表格

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

| 表頭1|表頭2|表頭3|表頭4
|-| :- | :-: | -: |
|默認(rèn)左對(duì)齊|左對(duì)齊|居中對(duì)其|右對(duì)齊|
|默認(rèn)左對(duì)齊|左對(duì)齊|居中對(duì)其|右對(duì)齊|
|默認(rèn)左對(duì)齊|左對(duì)齊|居中對(duì)其|右對(duì)齊|

| 參數(shù)           | 說(shuō)明                 |   默認(rèn)值            |
| ------------- |:-------------------:|:------------------:|
| host          | 遠(yuǎn)程主機(jī)的地址         |                    |
| user          | 使用者名稱            |                    |
| root          |  遠(yuǎn)程主機(jī)的根目錄      |                    |
| port          | 端口                 |       22           |
| delete        | 刪除遠(yuǎn)程主機(jī)上的舊文件   |  true              |
| verbose       | 顯示調(diào)試信息           |   true             |
| ignore_errors | 忽略錯(cuò)誤              |     false          |

效果：

總結(jié)

記錄了一下 Hexo 寫博客的環(huán)境配置惕虑，了解創(chuàng)建博客的過(guò)程和一些相關(guān)的變量，然后學(xué)習(xí)一下 Markdown 的基本語(yǔ)法規(guī)范磨镶，下次有時(shí)間在將 Markdown 更深入的使用方法記錄一下溃蔫。