
Hexo 新增文章:從 hexo new 到發布上線
hexo new "文章標題" 然後就可以開始寫了——但如果你想讓這篇文章被人找到,還有幾件事要做。
先講結論

新增文章的完整流程:hexo new → 填好 frontmatter(特別是 description 和 keywords)→ 確認 category_map / tag_map 沒有中文殘留 → 寫文章 → hexo g -d 部署。
hexo new:建立文章骨架
hexo new "你的文章標題"這會在 source/_posts/ 下產生一個 Markdown 檔案。打開來長這樣:
---
title: "你的文章標題"
date: 2024-09-08 16:18:42
tags: []
categories: []
description: ""
keywords: ""
---
正文開始...上面那段 --- 包起來的東西叫 frontmatter,是文章的 metadata。接下來教你怎麼填。
Frontmatter:SEO 的命脈
大部分人 hexo new 完就直接寫正文了。但 frontmatter 沒填好,搜尋引擎根本不知道你這篇在講什麼。
必填的幾個欄位:
- description:一兩句話描述文章內容。這會顯示在 Google 搜尋結果的摘要裡。不寫的話 Google 會自己抓,抓出來通常很醜
- keywords:跟文章相關的關鍵字,用逗號隔開
- categories:文章分類,建議用英文或搭配
category_map - tags:標籤,比分類更細
---
title: "React Hooks 入門指南"
date: 2024-09-08
description: "從 useState 到 useEffect,用實際範例帶你搞懂 React Hooks 的核心概念。"
keywords: "React, Hooks, useState, useEffect, 前端開發"
categories:
- 前端
tags:
- react
- hooks
---別忘了 category_map
如果你的 categories 用中文(像上面的「前端」),記得在 _config.yml 裡做映射:
category_map:
前端: frontend
tag_map:
前端: frontend不然 URL 會出現 %E5%89%8D%E7%AB%AF 這種亂碼。問我怎麼知道的?因為我踩過。
寫完了,部署吧
hexo g -d部署完之後,記得做三件事:
- 檢查線上頁面:確認排版沒跑掉、圖片有正常顯示
- 確認 sitemap 有更新:到
/sitemap.xml看看新文章有沒有出現 - 到 Google Search Console 提交 URL:如果想要更快被收錄的話
不用每篇都手動提交——sitemap 會自動通知搜尋引擎。但新站初期,手動提交可以加快收錄速度。
寫了一篇教人怎麼寫文章的文章,然後發現自己 frontmatter 忘記填 description。