Contents

hexo在blog貼圖

Hexo 文章中插入圖片的方法

在 Hexo 部落格撰寫文章時,正確管理和插入圖片非常重要。Hexo 提供了「資產資料夾(Asset Folder)」功能,讓每篇文章可以有專屬的圖片目錄。

啟用資產資料夾

首先在 _config.yml 中開啟此功能:

1
post_asset_folder: true

啟用後,每次用 hexo new post <title> 建立新文章時,Hexo 會自動在 source/_posts/ 目錄下建立一個與文章同名的資料夾。

例如,建立文章 my-first-post.md,會同時建立 my-first-post/ 資料夾,把圖片放進這個資料夾即可。

插入圖片的三種語法

1. Hexo 標籤語法(推薦)

使用 Hexo 提供的 asset_img 標籤,語法最簡潔且跨平台相容性最好:

1
{% asset_img example.png 這是圖片說明 %}

2. 相對路徑 Markdown 語法

使用標準 Markdown 圖片語法,路徑相對於當前文章:

1
![圖片說明](./example.png)

3. 連結語法

1
[點此查看圖片](example.png)

取得資產路徑

可以用 asset_path 標籤取得資產的完整路徑,適合在 HTML 標籤中使用:

1
{% asset_path example.png %}

注意事項

  • 圖片檔名建議用英文,避免中文路徑問題
  • 推薦使用 {% asset_img %} 標籤,相容性最好
  • 若使用外部圖片(如 CDN),直接用完整 URL 即可
  • 圖片建議壓縮後再上傳,減少頁面載入時間

參考資料