Hexo Debug 02:Markdown 文字連結語法渲染失敗

在檢查自己 Hexo Blog 網頁渲染情況時,發現一些 文字連結 (超連結) 竟然直接顯示出 本來的 Markdown 語法,非常不美觀,而且無法點擊網址進行跳轉。

1
2
3
This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

(用程式框框包裹是因為無法每次發生,然後我還沒想要處理圖床XD)

環境

Hexo: 6.3.0

hexo-cli: 4.3.0

NexT: 8.13.2

期望

每個文字連結渲染結果都能是這樣有底線的可跳轉文字:

This is an example inline link.

This link has no title attribute.

解決方法

使用 Hexo 的 Link 標籤外掛(Tag Plugins) 取代 Markdown 語法:

1
{% link text url [external] [title] %}

以前面的例子舉例:

1
2
This is {% link an example http://example.com/ "Title" %} inline link.
{% link This link http://example.net/ %} has no title attribute.

This is an example inline link.
This link has no title attribute.

就是換個語法達到一樣效果的 work around。

結語

雖然換個語法就能解決,但我還是習慣用本來的 Markdown 語法,所以都是遇到網頁渲染失敗時才使用 Hexo 的標籤外掛處理錯誤的文字連結。

此外 Hexo 的標籤外掛還有很多其他厲害的功能可以使用,但僅限用於 Hexo,使用其他 Markdown 閱讀器時很可能不支援。