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 评测:案例页的数据,日期写在每个例子里。