Obsidian Markdown 语法助手
帮助你编写正确的 Obsidian Markdown，避免链接、嵌入、标注和属性格式出错。
技能仅声明 Read、Write、Edit，未授予命令执行权限，权限范围相对有限；但 Write/Edit 可能直接修改用户笔记，未规定确认、备份、回滚或敏感数据处理，也建议安装外部 marketplace 依赖且数据流披露不足，因此扣分。
结构清晰，覆盖主要语法并提供示例；仓库 CI 和测试存在，但所给证据主要覆盖其他脚本，未覆盖该 Markdown 参考内容的关键路径。部分 callout 类型和 Obsidian 兼容性未给出失败反馈或版本验证，因此静态评分受限。
触发词、目标用户和主要场景较明确，覆盖 wikilink、embed、callout、properties 等需求；但未明确非适用边界、具体输入输出契约或中文示例。首选 substrate 依赖 GitHub marketplace，可能影响中国大陆网络可达性，但本地 fallback 可降低影响，因此扣分。
具备 frontmatter、分层章节、表格、正反例和限制性提示；仓库提供 MIT 许可证及整体 CI。该技能自身缺少版本、变更记录、维护责任和更新流程，外部 substrate 的优先级也增加了维护假设，因此扣分。
作为 Obsidian Markdown 速查表，示例直接可用，能覆盖核心书写任务；但静态审阅未验证示例在目标 Obsidian 版本中的实际渲染，部分规则可能过度简化，且缺少与官方规范或替代方案的充分比较，因此扣分。
内容包含可审计的代码块、表格和仓库内引用，仓库还有 CI；但没有针对该技能的专门测试、第三方执行证据或多源交叉验证，关键正确性仍主要依赖作者陈述，因此扣分。
- Write/Edit 可直接改写用户笔记；使用前应确认目标文件并保留版本控制或备份。
- 先验证 callout 类型、Properties 规则及 Mermaid 支持是否符合当前 Obsidian 版本。
- 优先 substrate 依赖 GitHub marketplace，网络受限环境应准备本地 fallback，避免安装步骤成为硬依赖。
- 该技能没有专门测试，不能把仓库其他脚本的 CI 结果视为本技能语法已验证。
这个 Skill 能做什么，适合哪些场景？
这是 claude-obsidian 仓库中的一个独立 Agent Skill，专门参考 Obsidian Flavored Markdown 的写法。它覆盖双向链接、内容嵌入、Callout、Properties、标签、高亮、数学公式、代码块、表格、Mermaid 和脚注。该 Skill 适合需要稳定创建或编辑 Obsidian 知识库页面的人，但它不是完整的知识库自动整理、检索或研究工作流。仓库 README 建议优先使用 kepano/obsidian-skills 中的同名 Skill，将本 Skill 作为自包含备用参考。
在创建或编辑 Obsidian 页面时，提供正确的 Obsidian Markdown 语法和示例；指导使用 [[页面名]] 双向链接、![[内容]] 嵌入、[!note] 等 Callout、YAML 属性、标签、==高亮==、MathJax/KaTeX 公式、代码块、表格、Mermaid 图表和脚注；同时列出常见错误，例如用普通 Markdown 链接代替内部链接、在 Callout 中使用 HTML、在属性中使用嵌套 YAML 或 ISO 日期时间。
- Obsidian 用户创建新知识页面，需要使用双向链接、别名或标题锚点时。
- 知识管理者整理资料，需要把图片、PDF、音频或其他页面嵌入笔记时。
- 研究人员编写带属性、标签、公式、表格或 Mermaid 图表的 Obsidian 页面时。
- 维护已有知识库的人修复失效链接、不可见 Callout 或格式错误的 frontmatter 时。
这个 Skill 有哪些优点和局限？
- 覆盖 Obsidian 常用扩展语法，包含可直接参考的示例。
- 明确说明双向链接、嵌入、Callout 和 Properties 的常见陷阱。
- 只有 name、description 和通用文件编辑工具限制，没有列出的平台专属动态命令或子代理机制。
- 采用 MIT 许可证，仓库整体为开源项目。
- 它只是语法参考 Skill，不负责自动摄取资料、建立知识图谱、检索内容或维护整个 Vault。
- README 未提供该单个 Skill 在非 Claude Code 客户端中的独立安装步骤。
- 内容建议优先使用 kepano/obsidian-skills 的权威版本，因此本地参考可能需要随 Obsidian 语法演进而更新。
如何安装这个 Skill？
完整仓库的 README 提供两种主要安装方式：克隆仓库并运行 git clone https://github.com/AgriciDaniel/claude-obsidian && cd claude-obsidian && bash bin/setup-vault.sh；或运行 claude plugin marketplace add AgriciDaniel/claude-obsidian，再运行 claude plugin install claude-obsidian@agricidaniel-claude-obsidian。目标 Skill 位于 skills/obsidian-markdown/SKILL.md。README 未说明单独安装该 Skill 到其他客户端的具体目录规则。
如何使用这个 Skill？
在需要创建或编辑 Obsidian 页面时使用触发语句，例如 write obsidian note、obsidian syntax、wikilink、callout、embed 或 obsidian markdown。该 Skill 的允许工具为 Read、Write 和 Edit；使用时应根据页面需求选择对应语法，并遵守其 frontmatter、标签和内部链接规则。
这个 Skill 与同类方案有什么区别？
README 将本 Skill 定位为 kepano/obsidian-skills 中同名 Skill 的自包含备用版本，并建议在该版本可用时优先使用后者。