盡管 Hexo 支持 MarkDown，但是我們卻不能像寫單獨(dú)的 MarkDown 文檔時(shí)那樣肆無(wú)忌憚。由于我們所寫的文檔是需要被解析為靜態(tài)網(wǎng)頁(yè)文件的，所以我們必須嚴(yán)格遵從 Hexo 的規(guī)范，這樣才能解析出條理清晰的靜態(tài)網(wǎng)頁(yè)文件。

新建文檔

假設(shè)我們的文章名為 “hello hexo markdwon”，在命令行鍵入以下命令即可：

$ hexo new "hello hexo markdown"

上述命令的結(jié)果是在 ./hexo/source/_posts 路徑下新建了一個(gè) hello-hexo-markdown.md 文件。

然后，我們就可以打開(kāi)編輯器盡情地寫作了。

文檔格式

我們使用文本編輯器打開(kāi)剛剛新建的 hello-hexo-markdown.md 文件，會(huì)發(fā)現(xiàn)其中已經(jīng)存在內(nèi)容：

--- title: hello hexo markdown date: 2016-11-16 18:11:25 tags: ---

這些內(nèi)容是干嘛的呢？事實(shí)上，他們就是用于設(shè)置 MarkDown 文檔在被解析為靜態(tài)網(wǎng)頁(yè)文件時(shí)的相關(guān)配置，這些配置參數(shù)一般位于文件中最上方以 --- 分隔的區(qū)域。

其中，title 的值是當(dāng)前文檔名，也是將來(lái)在網(wǎng)頁(yè)中顯示的文章標(biāo)題。

date 值是我們新建文檔時(shí)的當(dāng)?shù)貢r(shí)區(qū)時(shí)間。

tags 值是文檔的標(biāo)簽，我們可以隨意賦值為文檔貼標(biāo)簽。其用法如下：

--- title: hello hexo markdown date: 2016-11-16 18:11:25 tags: - hello - hexo - markdown ---

上面的配置參數(shù)為這篇文檔貼上了 hello、hexo、mardown 標(biāo)簽，如果站點(diǎn)使用的主題支持標(biāo)簽功能，MarkDown 文檔被解析為靜態(tài)網(wǎng)頁(yè)文件后就可以看到效果。

除了以上這些，還有很多預(yù)先定義的參數(shù) Front-mtter，我們這里選取一個(gè)常用且較為典型的配置參數(shù) categories 講解一下。

文章分類

categories 是用來(lái)給文章分類的，它跟 tags 不同的是其具有順序性和層次性。

例如，我們寫一篇關(guān)于 CSS3 動(dòng)畫的文章，我們可能會(huì)為其打標(biāo)簽 ”CSS3“、”動(dòng)畫“等，但是我們卻會(huì)將其分在 CSS/CSS3 類別下，這個(gè)是有一定的相關(guān)性、順序性和層次性。簡(jiǎn)單來(lái)說(shuō)，categories 有點(diǎn)兒像新建文件夾對(duì)文檔進(jìn)行分門別類的歸置。

categories 的用法同 tags 一樣，只不過(guò)斗個(gè) categories 值是分先后順序的。

引用資源

寫個(gè)博客，有時(shí)候我們會(huì)想添加個(gè)圖片啦 O.O，或者其他形式的資源，等等。

這時(shí)，有兩種解決辦法：

使用絕對(duì)路徑引用資源，在 Web 世界中就是資源的 URL

使用相對(duì)路徑引用資源

文章資源文件夾

如果是使用相對(duì)路徑引用資源，那么我們可以使用 Hexo 提供的資源文件夾功能。

使用文本編輯器打開(kāi)站點(diǎn)根目錄下的 _ config.yml 文件，將 post_asset_folder 值設(shè)置為 true。

post_asset_folder: true

上面的操作會(huì)開(kāi)啟 Hexo 的文章資源文件管理功能。Hexo 將會(huì)在我們每一次通過(guò) hexo new <title> 命令創(chuàng)建新文章時(shí)自動(dòng)創(chuàng)建一個(gè)同名文件夾，于是我們便可以將文章所引用的相關(guān)資源放到這個(gè)同名文件夾下，然后通過(guò)相對(duì)路徑引用。

相對(duì)路徑引用的標(biāo)簽插件

通過(guò)常規(guī)的 markdown 語(yǔ)法和相對(duì)路徑來(lái)引用圖片和其它資源可能會(huì)導(dǎo)致它們?cè)诖鏅n頁(yè)或者主頁(yè)上顯示不正確。我們可以通過(guò)使用 Hexo 提供的標(biāo)簽插件來(lái)解決這個(gè)問(wèn)題：

{% asset_path slug %} {% asset_img slug [title] %} {% asset_link slug [title] %}

比如說(shuō)：當(dāng)你打開(kāi)文章資源文件夾功能后，你把一個(gè) example.jpg 圖片放在了你的資源文件夾中，如果通過(guò)使用相對(duì)路徑的常規(guī) markdown 語(yǔ)法  ，它將 不會(huì) 出現(xiàn)在首頁(yè)上。（但是它會(huì)在文章中按你期待的方式工作）

！！！注意： 如果已經(jīng)開(kāi)啟了文章的資源文件夾功能，當(dāng)使用 MarkDown 語(yǔ)法引用相對(duì)路徑下的資源時(shí)，只需 ./資源名稱，不用在引用路徑中添加同名文件夾目錄層級(jí)。

正確的引用圖片方式是使用下列的標(biāo)簽插件而不是 markdown ：

{% asset_img example.jpg This is an example image %}

通過(guò)這種方式，圖片將會(huì)同時(shí)出現(xiàn)在文章和主頁(yè)以及歸檔頁(yè)中。

文章摘要

有的時(shí)候，主題模板配置的不夠好的話，Hexo 最終生成的靜態(tài)站點(diǎn)是不會(huì)自動(dòng)生成文章摘要的。

所以，為了保險(xiǎn)起見(jiàn)，我們也自己手動(dòng)設(shè)置文章摘要，這樣也方便避免自動(dòng)生成的摘要不優(yōu)雅的情況。

設(shè)置文章摘要，我們只需在想顯示為摘要的內(nèi)容之后添 <!-- more --> 即可。像下面這樣：

--- title: hello hexo markdown date: 2016-11-16 18:11:25 tags: - hello - hexo - markdown --- ? 我是短小精悍的文章摘要(??????)?? ? <!-- more --> ? 緊接著文章摘要的正文內(nèi)容

這樣，<!-- more --> 之前、文檔配置參數(shù)之后中的內(nèi)容便會(huì)被渲染為站點(diǎn)中的文章摘要。

注意！文章摘要在文章詳情頁(yè)是正文中最前面的內(nèi)容。

生成文件

清除緩存文件

為了避免不必要的錯(cuò)誤，在生成靜態(tài)文件前，強(qiáng)烈建議先運(yùn)行以下命令：

$ hexo clean

上述命令會(huì)清除本地站點(diǎn)文件夾下的緩存文件（db.json）和已有的靜態(tài)文件（public）。

生成靜態(tài)文件

寫好 MarkDown 文檔之后，我們就可使用以下命令生成靜態(tài)文件：

$ hexo generate

然后我們就可以啟動(dòng) Hexo 服務(wù)器，使用瀏覽器打開(kāi) http://localhost:4000 查看效果了。

示范

下圖是一篇經(jīng)過(guò)配置的簡(jiǎn)單文檔，生成靜態(tài)文件后在網(wǎng)站首頁(yè)顯示的結(jié)果。我們可以看到手動(dòng)設(shè)置的摘要，以及打的標(biāo)簽生效了。

文章來(lái)源： lfkid.github.io， 作者：lfkid，版權(quán)歸原作者所有，如需轉(zhuǎn)載，請(qǐng)聯(lián)系作者。

源文鏈接： https://lfkid.github.io/2016/11/16/Hexo%E6%95%99%E7%A8%8B%EF%BC%9A%EF%BC%88%E4%B8%89%EF%BC%89%E4%BD%BF%E7%94%A8Hexo%E5%86%99%E5%8D%9A%E5%AE%A2/

總結(jié)

以上是生活随笔為你收集整理的使用Hexo写博客的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。