让AI输出Obsidian专属Markdown：Agent Client for Obsidian的Prompt Injection原理与设置指南

让AI输出Obsidian专属MarkdownAgent Client for Obsidian的Prompt Injection原理与设置指南【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-clientAgent Client for Obsidianobsidian-agent-client是一款通过 Agent Client ProtocolACP把 Claude Code、Codex、Gemini CLI 等 AI Agent 接入 Obsidian 的插件。它的Prompt Injection提示注入功能会在每次会话的第一条消息中自动追加简短的排版指令让 AI 直接输出 Obsidian 专属的 Markdown 格式——[[双链]]、$数学公式$、规范的表格全部开箱即用。本文带你快速搞懂它的原理与设置方法。为什么 AI 生成的 Markdown 在 Obsidian 里不对味AI Agent 是在标准 Markdown 上训练的而 Obsidian 有自己的扩展语法。没有引导时AI 的输出常出现三个问题问题AI 的默认输出Obsidian 期望的输出笔记引用Note[[Note Name]]双链可构建反向链接图谱数学公式\(...\)或\[...\]$...$与$$...$$Markdown 表格紧贴上文无空行表格前留空行否则渲染为纯文本Prompt Injection 的思路很直接在 AI 的上下文里塞入几句简短指令让它从第一轮回复起就说 Obsidian 方言。Prompt Injection 工作原理只注入一次管整个会话具体机制在源码 src/services/message-sender.ts 的buildSystemInstructions函数中可以看得很清楚当你发出新会话的第一条消息时插件会把你勾选的指令拼接到提示词中同一会话的后续消息不会重复注入指令会在 Agent 的上下文窗口生命周期内持续生效每条指令都非常短几乎不额外消耗 Token。官方文档 docs/usage/prompt-injection.md 对机制和指令原文有完整说明。快速配置3步启用 Obsidian Markdown 注入第 1 步进入设置页打开 Obsidian → 设置 →Agent Client→ 找到Prompt injection分区界面渲染代码位于 src/ui/SettingsTab.ts。第 2 步打开主开关启用Inject Obsidian Markdown instructions总开关。关闭它时无论子开关状态如何都不会注入任何指令。第 3 步按需勾选子开关主开关打开后只勾选你需要的三项指令即可所有选项默认开启。4 个设置项怎么选设置项默认说明Inject Obsidian Markdown instructions✅ 开总开关控制是否注入任何指令Wikilink formatting✅ 开让 AI 引用笔记时写[[Note Name]]双链Markdown table spacing✅ 开让 AI 在表格前留空行保证正确渲染LaTeX math formatting✅ 开让 AI 使用$...$/$$...$$数学分隔符容易混淆这里的Wikilink formatting是让 AI写[[双链]]而 Mentions 设置里的Expand wikilink context是把笔记里已有的[[链接]]解析成文件路径给 Agent 读取方向相反详见 docs/usage/mentions.md。配置完成后AI 在 Obsidian 里输出的双链、公式和表格都会原生渲染就像下面这样什么时候应该关掉 Prompt Injection以下场景可以考虑关闭部分或全部开关你的写作以纯散文为主不涉及笔记引用、公式和表格Agent 在你的使用场景下已经稳定遵循 Obsidian 约定想尽量压缩首条提示词长度节省性能或 Token 费用。⚠️ 如果开关打开但 AI 仍忽略某条指令这属于 Agent 自身能力限制而不是插件 Bug。可以换个更强的模型或在自己的消息里手动重申一遍要求。进阶用上下文文件做长期引导Prompt Injection 是轻量补丁只影响首轮消息。如果你希望 Agent整个 Vault 期间都记住写作风格、目录约定可以配合上下文文件CLAUDE.md/AGENTS.md/GEMINI.md使用两者互补、互不冲突参见 docs/usage/context-files.md。小结Prompt Injection 是 Agent Client for Obsidian 里性价比极高的功能——零成本、零侵入只需在设置页确认几个开关AI 的输出就能从标准 Markdown升级为Obsidian 专属 Markdown。新手强烈建议保持默认全开。【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考