JSON-LD 是什麼?結構化資料的寫法,部落客其實不用自己寫

JSON-LD 是 Google 最推薦的結構化資料寫法,用一段獨立的程式碼,把你文章的標題、作者、FAQ 標成搜尋引擎和 AI 看得懂的格式。好消息是:部落客幾乎不用自己寫,WordPress 的 SEO 外掛會自動幫你產生。這篇用白話帶你看懂它長什麼樣、放在哪、怎麼確認有沒有生效。

你大概在某篇 SEO 教學看過 JSON-LD 這個詞,點進去全是一堆程式碼,看得頭很痛,懷疑自己是不是也得學會寫。先別緊張,這篇不是要你當工程師。

JSON-LD 是什麼?一段看懂

JSON-LD 是一種用 JSON 格式描述網頁內容的結構化資料寫法,全名是 JavaScript Object Notation for Linked Data。講白話,它就是一段給機器看的小抄,告訴搜尋引擎「這段是常見問答、這個是作者、這篇是食譜」,讓 Google 和 AI 不用用猜的就讀懂你的內容。

它最大的特色是結構與視覺分離:這段小抄獨立放在一個程式碼區塊裡,不會混進你文章的版面,讀者看不到、也不影響排版,純粹是寫給搜尋引擎看的。想先把結構化資料的整體觀念補齊,可以看 結構化資料懶人包,這篇則專門講 JSON-LD 這個「寫法」本身。

JSON-LD、Microdata、RDFa 差在哪?為什麼 Google 推 JSON-LD

結構化資料總共有三種寫法:JSON-LD、Microdata、RDFa,其中 JSON-LD 是 Google 官方首選。差別主要在「程式碼寫在哪」,先用一張表看清楚:

語法格式程式碼寫在哪Google 態度維護難度
JSON-LD獨立的 script 區塊,和內容分開推薦首選最好維護,改版不易壞
Microdata直接標在 HTML 標籤裡支援,但部分屬性沒有改版容易連帶弄壞
RDFa標進 HTML 標籤的屬性支援,但較少人用寫起來最繁瑣

為什麼 Google 推 JSON-LD?因為它把標記和內容分開,搜尋引擎好讀、你也好維護,改網站版面時不會把標記一起改壞。Google 自己有講過,三種寫法效果其實沒有差別,挑順手的用就好,但要注意:不少屬性 Microdata 並不支援,所以真的要標,JSON-LD 最不會卡關。

JSON-LD 長什麼樣子?放在網頁哪裡

JSON-LD 是一段包在 script 標籤裡、類型標成 application/ld+json 的程式碼,通常放在網頁的開頭區(head)或內容最底部。下面是一段最簡單的文章(Article)範例,給你感受一下它的長相:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "JSON-LD 是什麼?一篇看懂",
  "author": {
    "@type": "Person",
    "name": "金城"
  },
  "datePublished": "2026-06-01"
}
</script>

看不懂每一行也沒關係,重點是感受它的邏輯:用「欄位名稱配內容」一條一條把資訊列清楚,@type 說這是文章、headline 是標題、author 是作者。真正在用的時候,這些通常是外掛自動幫你填好的。

Q:JSON-LD 一定要我複製貼上嗎?
A:不用。除非你要標一個外掛沒支援的特殊類型,才會手動貼一段;日常文章、FAQ、麵包屑這些,外掛都會自動產生,你連碰都不用碰。

部落客要自己寫 JSON-LD 嗎?

答案是:不用自己寫。只要你用 WordPress,裝一套 SEO 外掛,它就會在背後幫你自動產生 JSON-LD。像 Rank Math 免費版就內建十幾種類型、Yoast 會自動串好 Schema Graph、Slim SEO 裝了就自動標基本款,這些全都是 JSON-LD 格式,你不需要碰一行程式碼。

不過要先講清楚一個常見誤會:「自動產生」不代表你完全不用動手。外掛幫你免掉的是「寫語法」,那些大括號、引號、@type 怎麼擺對都它包辦;但有些內容外掛生不出來,還是得你自己填。簡單分成兩種:

外掛自動幫你填好(抓 WordPress 現有資料)需要你自己填內容的欄位
文章標題、發佈與更新日期FAQ:每一組問題與答案
作者名稱、網站名稱HowTo:每一個操作步驟
精選圖片、文章網址食譜:烹調時間、份量、星等評分
麵包屑階層商品:價格、評分、庫存狀態

左邊這些基本款是真的全自動,因為你打文章時資料就在了,外掛直接拿去組。右邊這些進階類型不一樣,內容 WordPress 本來沒有,所以你要在外掛給的欄位或區塊裡,把每一組問答、每一個步驟、每一個數字一個一個填進去,外掛再幫你翻成正確的 JSON-LD。你填的是內容,不是程式碼,這點不用怕。只有極少數外掛完全沒支援的特殊類型,才需要自己貼一整段,日常幾乎遇不到。

所以對部落客來說,懂 JSON-LD 不是為了「會寫」,而是為了三件事:看得懂外掛幫你標了什麼、出問題時知道去哪檢查、選外掛時知道誰標得多誰標得少。要比較哪套外掛的結構化功能最划算,可以看 結構化資料外掛怎麼選

怎麼確認 JSON-LD 有沒有生效?

最快的方法是用 Google 的複合式搜尋結果測試工具(Rich Results Test),把你的網址貼進去,它會告訴你這頁抓到哪些結構化類型、有沒有錯誤或警告。想看更完整的標記內容,也可以用 schema.org 的 Schema Markup Validator。

舉個實際情境:有位美食部落客裝了 Rank Math、在食譜文章標了評分,但搜尋結果一直沒長出星星。把網址丟進測試工具一驗,馬上看到 Recipe 類型有個欄位填錯,補上就過了。三種語法你只要會用這複合式搜尋結果測試工具,就能自己檢查,不用等別人幫你看。記得標記改完後重新測一次,確認沒有紅字再放心。

JSON-LD 對 AI 搜尋有什麼幫助?

在 AI 搜尋的時代,JSON-LD 的價值更高了。因為它把你的內容整理成乾淨、結構清楚的資料,AI 摘要在抓取和引用時更省力,也更容易把你的內容當成可信來源。一篇沒有標記的純文字,AI 要自己猜結構;一篇標好 JSON-LD 的文章,AI 直接讀懂哪段是答案、哪段是步驟。

這也是為什麼 FAQ 這類標記越來越重要,AI 摘要特別愛引用結構清楚的問答。FAQ 怎麼標、為什麼在 AI 時代更不能少,可以看 FAQPage 結構化資料指南

金城老師觀點

金城老師觀點

我常跟部落客說,JSON-LD 不要被它的程式碼長相嚇到。我自己這麼多年,幾乎沒有手刻過 JSON-LD,全都交給外掛自動產生,省下來的時間拿去寫內容更實在。真正要花心思的,是「你有沒有把該標的類型標起來」,還有「標完有沒有去測試工具驗一次」。我看過太多人裝了外掛卻從來沒檢查,結果某個欄位填錯、複合式結果一直長不出來都不知道。懂原理,是為了會檢查、會除錯,不是為了會寫程式,這個順序對部落客來說很重要。

延伸閱讀

參考資料

常見問題

JSON-LD 和 Schema 有什麼不一樣?

Schema(schema.org)是一套詞彙表,規定有哪些類型和欄位;JSON-LD 是把這套詞彙寫出來的格式之一。簡單說,Schema 是要標什麼內容,JSON-LD 是怎麼寫,兩個搭在一起用。

部落客需要自己會寫 JSON-LD 嗎?

幾乎不用。WordPress 的 SEO 外掛,像 Rank Math、Yoast、Slim SEO,都會自動幫你產生 JSON-LD。懂原理是為了看得懂、能除錯,不是要你手刻程式。

JSON-LD 要放在 head 還是 body?

兩個位置 Google 都讀得到。用外掛的話它會自動幫你放好,你不用自己決定位置。

同一頁可以放好幾段 JSON-LD 嗎?

可以,一頁放多段是正常的。但同一種類型不要重複輸出,例如兩個外掛都標文章,會讓 Google 混淆,挑一套主力標就好。

怎麼知道我的 JSON-LD 有沒有寫錯?

用 Google 的複合式搜尋結果測試工具,把網址貼進去就會列出抓到哪些類型、有沒有錯誤;schema.org 的驗證工具也可以檢查。

文章目錄