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

新建文檔

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

$ hexo new "hello hexo markdown"

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

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

文檔格式

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

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

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

其中，title 的值是當前文檔名，也是將來在網(wǎng)頁中顯示的文章標題。

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

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

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

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

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

文章分類

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

例如，我們寫一篇關(guān)于 CSS3 動畫的文章，我們可能會為其打標簽 ”CSS3“、”動畫“等，但是我們卻會將其分在 CSS/CSS3 類別下，這個是有一定的相關(guān)性、順序性和層次性。簡單來說，categories 有點兒像新建文件夾對文檔進行分門別類的歸置。

categories 的用法同 tags 一樣，只不過斗個 categories 值是分先后順序的。

引用資源

寫個博客，有時候我們會想添加個圖片啦 O.O，或者其他形式的資源，等等。

這時，有兩種解決辦法：

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

使用相對路徑引用資源

文章資源文件夾

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

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

post_asset_folder: true

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

相對路徑引用的標簽插件

通過常規(guī)的 markdown 語法和相對路徑來引用圖片和其它資源可能會導(dǎo)致它們在存檔頁或者主頁上顯示不正確。我們可以通過使用 Hexo 提供的標簽插件來解決這個問題：

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

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

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

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

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

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

文章摘要

有的時候，主題模板配置的不夠好的話，Hexo 最終生成的靜態(tài)站點是不會自動生成文章摘要的。

所以，為了保險起見，我們也自己手動設(shè)置文章摘要，這樣也方便避免自動生成的摘要不優(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)容便會被渲染為站點中的文章摘要。

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

生成文件

清除緩存文件

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

$ hexo clean

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

生成靜態(tài)文件

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

$ hexo generate

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

示范

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

文章來源： lfkid.github.io， 作者：lfkid，版權(quán)歸原作者所有，如需轉(zhuǎn)載，請聯(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写博客的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

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