指南 · Obsidian

Obsidian 插件怎么在 AI 搜索里被找到?

更新于 2026-11-11 · kagentx

短答案

你的插件在公开网页上只有三处:社区目录的插件页(标题来自 name,meta description 来自 description,正文基本是 README)、GitHub 仓库首页、以及只有五个字段的 community-plugins.json。2026-11-11 实测:obsidian.md 的 robots.txt 全部放行,GitHub 对 AI 爬虫禁的是 raw、目录树等子路径,仓库首页没禁。所以要做的是把 description 和 README 第一屏写清楚。

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 实测)
idmanifest.json 的 id插件页网址 community.obsidian.md/plugins/<id>;必须唯一,不能含 obsidian
namemanifest.json 的 name插件页 <title>(“Git - Obsidian Plugin”)和 <h1>;应用内搜索也用它
authormanifest.json 的 author插件页上的作者名;应用内搜索用
descriptionmanifest.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.md200,23 字节:User-agent * Allow: /没有点名任何 AI 爬虫,全部放行
community.obsidian.md没有真正的 robots.txt:/robots.txt 返回 200,但内容是 HTML 页面;首页带 noindex,插件样本页没有 robots meta没有 robots 规则可读;首页 noindex,插件页本身没有 noindex
github.comGPTBot、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. 1. 第一句描述写成人会搜的话

    description 会同时出现在 meta description 和应用内搜索里。写「这个插件做什么、给谁用」,不要只写功能名。例:「Integrate Git version control with automatic backup」比「Git plugin」更容易被引用。

  2. 2. README 首屏先答「它是什么、怎么装、能做什么」

    按上面的模板写。装法写成 Settings > Community plugins > Browse,这是用户会照着问的问题。

  3. 3. 在 GitHub 仓库的 About 里再写一句

    仓库 About 的文字会出现在仓库首页的 title 和 description 里。样本里它和目录的 description 不一样,两处各写一遍,等于给 AI 两个读到你的机会。

  4. 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. 5. 在 ChatGPT、Perplexity 里问三次

    问「Obsidian 里怎么做 X」,开联网搜索,记下推荐了哪些插件、引用了哪些网址。ChatGPT 或 Perplexity 是否引用 community.obsidian.md 的插件页,我们没有证据,未核实,要靠你自己测。

和别的插件市场比,Obsidian 有什么不同?

Obsidian 社区目录GitHub 仓库
谁生成页面目录从 manifest 和 README 生成你自己
能改的文字name、description(改 manifest)、READMEAbout、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,插件样本页没有。官方没有解释原因,未核实。

出处

kagentx

想知道 AI 回答里
有没有你?

评测把买家的问题拿去问 ChatGPT、Perplexity、Claude(开联网搜索),记下推荐了谁、引用了哪些网页、你在不在里面。基础版 $1,一般 2–3 分钟出结果。