Obsidian 外掛的資訊出現在哪些公開頁面上?
三處:社群目錄裡你的外掛頁、GitHub 儲存庫首頁(也就是 README),以及 community-plugins.json 這份清單。2026-11-11 我們取了一個樣本外掛(Git):obsidian.md/plugins?id=obsidian-git 會 301 到 community.obsidian.md/plugins/obsidian-git,這個頁面的 HTML 裡直接有標題、描述、canonical、h1 和 README 內文,不需要執行腳本。
community-plugins.json 當天有 10,232 筆,每筆只有 id、name、author、description、repo 五個欄位,沒有 README、沒有標籤、沒有截圖。所以 AI 能從這份清單讀到的,只有你的名稱、作者和一句話描述。
這五個欄位分別從哪裡來、出現在哪裡?
| 欄位 | 來源 | 出現在哪裡(2026-11-11 實測) |
|---|---|---|
| id | manifest.json 的 id | 外掛頁網址 community.obsidian.md/plugins/<id>;必須唯一,不能含 obsidian |
| name | manifest.json 的 name | 外掛頁 <title>(“Git - Obsidian Plugin”)和 <h1>;應用程式內搜尋也用它 |
| author | manifest.json 的 author | 外掛頁上的作者名;應用程式內搜尋用 |
| description | manifest.json 的 description | 外掛頁的 meta description,和 community-plugins.json 裡的那句完全一樣 |
| repo | 你提交的 GitHub 儲存庫 | 外掛頁讀取 README 的地方;也是 AI 能看到的另一個頁面(儲存庫首頁) |
官方文件(Manifest 頁)把 name、author、description、id、isDesktopOnly、minAppVersion、version 都列為必填。name 要短、具描述性,不能含 “Obsidian”,外掛名稱不能含 “Plugin”。description 官方沒有寫字數上限,未核實。出自 obsidian-developer-docs,2026-11-11 讀 GitHub 上的原文。
README 在外掛頁上起什麼作用?
官方的提交文件寫明:README.md 要說明外掛的用途和用法,摘要會顯示在公開的列表頁,相對連結和圖片會改寫成指向你的儲存庫。我們取到的樣本頁,可見文字約 1 萬字元,裡面就有 README 的段落(功能列表、文件連結、行動裝置說明)。
也就是說,外掛頁的內文基本就是你的 README。README 的第一段寫不清楚,AI 在外掛頁和儲存庫首頁讀到的就是同樣含糊的東西。寫法見 GitHub README 會被 AI 搜尋引用嗎?,開源專案的整體做法見 開源專案怎麼被 AI 搜尋推薦?README 以外的 6 個地方。
# Git (title: what it does, in the plain words people search) One sentence: what the plugin does and for whom. Install: Settings > Community plugins > Browse > search the name. Features: a bullet list, one real feature per line. Settings and commands: the exact command names. Mobile / desktop only: say it. Changelog: link to GitHub releases.
obsidian.md 和 GitHub 的 robots.txt 對 AI 爬蟲怎麼設?
| 網站 | robots.txt 現況(2026-11-11) | 對 AI 爬蟲意味著什麼 |
|---|---|---|
| obsidian.md | 200,23 位元組:User-agent * Allow: / | 沒有點名任何 AI 爬蟲,全部放行 |
| community.obsidian.md | 沒有真正的 robots.txt:/robots.txt 回傳 200,但內容是 HTML 頁面;首頁帶 noindex,外掛樣本頁沒有 robots meta | 沒有 robots 規則可讀;首頁 noindex,外掛頁本身沒有 noindex |
| github.com | GPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、Claude-SearchBot、Claude-User、PerplexityBot、Perplexity-User 共用一組,Crawl-delay: 1,約 280 條 Disallow | 禁的是 /*/raw/、/*/tree/、/*/blame/、/*/archive/、提交列表、比較頁等;儲存庫首頁不在 Disallow 裡(按文字讀,未用真實爬蟲驗證) |
| github.com(Bytespider) | Disallow: / | 整站禁止 |
所以 AI 爬蟲能讀到的是:社群目錄的外掛頁,以及 GitHub 儲存庫首頁和渲染後的 README。讀不到的是 raw 檔案和目錄樹,這意味著把關鍵說明只放在 docs/ 下的某個子檔案裡,不如放在 README 首頁。robots.txt 的寫法見 AI 爬蟲的 robots.txt 怎麼寫?。
提交之後,我應該做什麼?
1. 第一句描述寫成人會搜的話
description 會同時出現在 meta description 和應用程式內搜尋裡。寫「這個外掛做什麼、給誰用」,不要只寫功能名。例:「Integrate Git version control with automatic backup」比「Git plugin」更容易被引用。
2. README 首屏先答「它是什麼、怎麼安裝、能做什麼」
照上面的範本寫。安裝方式寫成 Settings > Community plugins > Browse,這是使用者會照著問的問題。
3. 在 GitHub 儲存庫的 About 裡再寫一句
儲存庫 About 的文字會出現在儲存庫首頁的 title 和 description 裡。樣本裡它和目錄的 description 不一樣,兩處各寫一遍,等於給 AI 兩個讀到你的機會。
4. 用 curl 看一遍公開頁
把 id 換成你的外掛,看標題、描述是不是你寫的那句,README 裡的一句話能不能 grep 到。內文要在 HTML 裡,原因見 AI 爬蟲會執行 JavaScript 嗎?。
# What does the public plugin page say in raw HTML? curl -sL -A "Mozilla/5.0" "https://obsidian.md/plugins?id=YOUR-PLUGIN-ID" | grep -io '<title>[^<]*</title>' curl -sL -A "Mozilla/5.0" "https://obsidian.md/plugins?id=YOUR-PLUGIN-ID" | grep -io '<meta[^>]*name="description"[^>]*>' curl -sL -A "Mozilla/5.0" "https://obsidian.md/plugins?id=YOUR-PLUGIN-ID" | grep -c "a sentence from your README"
5. 在 ChatGPT、Perplexity 裡問三次
問「Obsidian 裡怎麼做 X」,開聯網搜尋,記下推薦了哪些外掛、引用了哪些網址。ChatGPT 或 Perplexity 是否引用 community.obsidian.md 的外掛頁,我們沒有證據,未核實,要靠你自己測。
和別的外掛市集比,Obsidian 有什麼不同?
| Obsidian 社群目錄 | GitHub 儲存庫 | |
|---|---|---|
| 誰產生頁面 | 目錄從 manifest 和 README 產生 | 你自己 |
| 能改的文字 | name、description(改 manifest)、README | About、README、Topics |
| AI 爬蟲能讀到 | 標題、描述、README 內文(樣本頁) | 儲存庫首頁和 README;raw、目錄樹被禁 |
| 官方沒寫的 | description 字數上限、AI 是否引用 | — |
做的是 Figma 外掛的話,Figma 社群外掛頁的 robots.txt、sitemap 和官方上架要求見 Figma 外掛怎麼被 AI 搜尋找到?社群外掛頁的 robots、sitemap 與官方要求。
同樣是外掛生態,做 Minecraft 模組或伺服器外掛的話,Modrinth 和 CurseForge 的頁面實測見 Minecraft 模組怎麼被 AI 搜尋找到?。
常見問題
Obsidian 外掛的頁面能被 ChatGPT、Perplexity 讀到嗎?
按 2026-11-11 的實測,外掛頁的 HTML 裡直接有標題、描述、canonical 和 README 內文,沒有 noindex。真實 AI 爬蟲是否讀取、是否引用,我們沒有證據,未核實。
community-plugins.json 裡有哪些欄位?
id、name、author、description、repo 五個,2026-11-11 共 10,232 筆。沒有 README 和截圖。
外掛的 description 有字數限制嗎?
官方 Manifest 頁沒有寫數字,未核實。建議寫成一句話,說清做什麼、給誰用。
GitHub 會不會禁止 AI 爬蟲讀我的 README?
github.com/robots.txt 對八個 AI 爬蟲的 Disallow 主要是 raw、目錄樹、提交、比較等子路徑,儲存庫首頁不在其中。這是按文字讀的,沒有用真實爬蟲驗證。
外掛名稱裡能放關鍵字嗎?
官方要求名稱短、具描述性,不能含 “Obsidian”,外掛名稱不能含 “Plugin”。關鍵字放進 description 和 README 裡。
要不要給外掛單獨做一個介紹網站?
不是必須。外掛頁和 README 已經是伺服器端直出的內文。如果要做,把它寫成一個說明頁,內容和 README 一致,並連回外掛頁。
community.obsidian.md 首頁為什麼是 noindex?
我們只看到首頁帶 noindex,外掛樣本頁沒有。官方沒有解釋原因,未核實。
出處
- Obsidian · community-plugins.json (2026-11-11 抓取)
- Obsidian · Submit your plugin (2026-11-11 讀原文)
- Obsidian · Manifest (2026-11-11 讀原文)
- GitHub · robots.txt (2026-11-11 抓取)
- Obsidian · robots.txt (2026-11-11 抓取)
- kagentx 評測:案例頁的資料,日期寫在每個例子裡。