Obsidian Markdown 编辑技能
帮助智能体创建和维护符合 Obsidian 语法的 Markdown 笔记。
技能仅指导编辑 Markdown、添加链接、嵌入和属性，未显示恶意行为、凭据窃取或外传，也未要求超出文件编辑所需的权限；但缺少用户确认、敏感数据处理、变更回滚和数据流说明，因此扣分。
工作流和示例内部基本一致，且提供了属性、嵌入和 callout 参考；但没有测试、版本兼容矩阵、异常输入处理或可诊断的失败反馈，静态审查不支持超过 10 分，因此扣分。
名称、描述和适用场景明确，覆盖 Obsidian Markdown 扩展，并说明标准 Markdown 属于前置知识；但未清晰列出非适用范围、触发边界或中文使用指导，且没有环境兼容证据，因此扣分。
文档按工作流和专题参考分层，包含安装方式、示例、官方参考链接和 MIT 许可证；但缺少版本信息、变更日志、维护责任、更新路径及故障排查说明，因此扣分。
提供了可直接复用的 wikilink、embed、callout、属性、标签、数学和 Mermaid 示例，足以覆盖核心编辑任务；但未有执行验证或代表性输出验证，结果仍需用户检查，因此按静态上限给 7 分。
内容包含具体语法、完整示例和指向 Obsidian 官方文档的引用，具备有限可审计性；但没有提交测试、CI 覆盖或独立复现证据，静态审查最多给 5 分。
- “验证笔记在 Obsidian 阅读视图中正确渲染”无法仅凭这些文件完成，使用者仍需在目标 Obsidian 版本中检查。
- 外部图片和链接示例可能引入网络、隐私或可用性风险；技能未定义确认、来源审查或失败恢复流程。
- 未声明支持的 Obsidian 版本，也未提供维护和更新承诺。
这个 Skill 能做什么，适合哪些场景？
该技能专门处理 Obsidian Flavored Markdown（`.md`）文件。它指导智能体使用属性、双向链接、嵌入、标注、标签、注释、高亮、数学公式、Mermaid 图表和脚注等 Obsidian 特有语法。它适合需要直接维护 Obsidian 知识库的用户。技能要求标准 Markdown 已被掌握，并不覆盖 Obsidian Bases、JSON Canvas 或 Obsidian CLI。
创建或编辑 .md 笔记；在文件顶部添加 YAML 属性；使用 [[Note]] 双向链接连接库内笔记；使用 ![[...]] 嵌入笔记、图片或 PDF；添加 callout、标签、注释、高亮、LaTeX、Mermaid 图表和脚注；指导用户在 Obsidian 阅读视图中检查渲染结果。
- Obsidian 用户创建带有标题、标签、别名和日期属性的新笔记。
- 知识库维护者把相关笔记连接为可追踪的双向链接网络。
- 研究人员在笔记中嵌入图片、PDF 页面或其他笔记内容。
- 项目成员使用 callout 突出提醒、风险、问答或关键结论。
- 文档作者在 Obsidian 笔记中加入数学公式、Mermaid 流程图和脚注。
这个 Skill 有哪些优点和局限？
- 覆盖 Obsidian Markdown 中常用的链接、嵌入、属性和视觉标注语法。
- 提供创建笔记的分步工作流和可直接参考的语法示例。
- 采用仅包含 `name` 和 `description` 的标准 SKILL.md 前置元数据。
- 仓库采用 MIT 许可证。
- 只覆盖 Obsidian Markdown 扩展，标准 Markdown 被视为已有知识。
- 不包含 Obsidian Bases、JSON Canvas、Obsidian CLI 或网页内容提取能力。
- 来源未提供自动化测试套件、支持平台矩阵或失败恢复机制。
- 渲染检查被列为工作流步骤，但未说明如何自动执行验证。
如何安装这个 Skill？
该技能属于 kepano/obsidian-skills 多技能仓库，来源只提供仓库级安装方式。Marketplace：运行 /plugin marketplace add kepano/obsidian-skills，再运行 /plugin install obsidian@obsidian-skills。npx skills：运行 npx skills add https://github.com/kepano/obsidian-skills。Claude Code：将仓库内容放入 Obsidian vault 根目录的 /.claude 文件夹。Codex：将 skills/ 目录复制到通常为 ~/.codex/skills 的技能路径。OpenCode：运行 git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills，然后重启 OpenCode。
如何使用这个 Skill？
在支持 Agent Skills 的客户端中处理 Obsidian .md 文件，或明确提到 wikilinks、callouts、frontmatter、tags、embeds 或 Obsidian notes。例如：Create an Obsidian note with frontmatter, wikilinks, a callout, and an embedded image. 具体的客户端触发方式和自动发现行为，除 README 中列出的安装说明外未作进一步说明。