obsidian-markdown
作者 kepanoobsidian-markdown 可帮助生成符合 Obsidian Flavored Markdown 规范的内容，支持 wikilinks、embeds、callouts 和 YAML frontmatter。适合用于基于 vault 的笔记、文档和知识库，尤其适合需要统一 Obsidian 语法的场景。
该技能评分为 78/100，对于需要让代理稳定生成或编辑 Obsidian 专用 Markdown 的用户来说，是一个值得收录的目录候选。仓库提供了清晰的触发线索、实用的笔记创建流程，以及围绕 properties、embeds 和 callouts 的聚焦语法参考；不过用户也应预期，这更偏向一个以文档为核心的技能，而不是带自动化能力或严格校验规则的可执行工作流。
- 触发场景明确：描述清楚说明了何时应使用该技能，涵盖 wikilinks、callouts、frontmatter、tags、embeds 和 Obsidian 笔记等场景。
- 操作说明清晰：SKILL.md 提供了分步骤的笔记创建流程，并明确区分了 wikilinks 与标准 Markdown 链接。
- 参考资料实用：单独文档覆盖 properties、embeds 和 callouts，并提供了具体的语法示例与支持的变体。
- 未提供安装命令、脚本或规则，因此采用该技能主要依赖阅读文档，而不是直接调用工具化工作流。
- 能力范围刻意保持精简，未涵盖标准 Markdown 指南；当任务同时涉及 Obsidian 语法与更广泛的格式需求时，能力较弱的代理可能需要自行判断。
obsidian-markdown skill 概览
obsidian-markdown 能做什么
obsidian-markdown skill 的作用，是帮助 AI 生成和编辑符合 Obsidian Flavored Markdown 规范的内容，而不只是普通 Markdown。它重点处理那些在常规提示词里最容易出错的语法：[[wikilinks]]、![[embeds]]、YAML frontmatter 属性、tags、aliases，以及 Obsidian callouts（如 > [!note]）。如果你的笔记保存在 Obsidian vault 里，这个 skill 会比一句普通的“写 markdown”指令更实用。
谁适合安装 obsidian-markdown
这个 obsidian-markdown skill 最适合在 Obsidian 里搭建个人知识库、团队文档 vault、研究笔记或项目笔记的用户。尤其当你希望助手生成的笔记从一开始就符合 vault 规范，而不是生成后还要手动清理格式时，它会很有价值。
它真正解决的工作需求
大多数用户并不需要别人帮忙写标题或项目符号列表；他们真正需要的，是能产出链接正确、在 Obsidian 中渲染正常、并持续使用 vault 原生特性的笔记。obsidian-markdown for Knowledge Bases 的实际价值，就在于它会把模型引导到 Obsidian 特有的决策上：比如什么时候该用 [[Note]] 而不是 [text](url)，属性该怎么组织，以及如何嵌入笔记、媒体、标题或 block references。
为什么这个 skill 值得用
这个仓库体量不大，但非常聚焦。它不讲泛泛的笔记方法论，而是提供了一条明确的工作流，以及三个最容易导致格式漂移的语法参考文件：references/PROPERTIES.md、references/EMBEDS.md 和 references/CALLOUTS.md。如果你主要担心的是语法写错、格式失真，而不是没有写作思路，那么 obsidian-markdown skill 很值得安装。
如何使用 obsidian-markdown skill
安装后先看什么
进行 obsidian-markdown install 时，先把上级 skill 仓库加入你的 skills 环境，然后优先阅读 skills/obsidian-markdown/SKILL.md。接着直接看这几个文件：
references/PROPERTIES.mdreferences/EMBEDS.mdreferences/CALLOUTS.md
相比泛泛地浏览整个仓库，这几个文件更关键，因为它们定义了这个 skill 要求模型遵守的具体语法模式。
obsidian-markdown 需要什么输入
这个 skill 在你提供“理解 vault 语境”的输入时效果最好，而不只是给一个主题。建议包含：
- 笔记用途：daily note、concept note、project page、meeting summary
- 期望的 properties：
title、tags、aliases、status 字段、日期 - 已知要通过
[[...]]引用的关联笔记 - 内容是否需要使用 callouts、embeds，或两者都要
- 命名约定：filename 风格、tag 风格、frontmatter 风格
一个较弱的提示词是：“Write an Obsidian note about databases.”
一个更强的 obsidian-markdown usage 提示词是：“Create an Obsidian note named Database Indexing with YAML frontmatter for title, tags, and aliases; link to [[Query Optimization]]; add a folded warning callout for tradeoffs; include an embed placeholder for ![[B-Tree Diagram.png|300]].”
把模糊目标变成可用提示词
这个 skill 的高质量提示词，重点应放在输出约束，而不只是主题本身。可以按这个模式来写：
- 说明笔记类型和目标读者。
- 指定 frontmatter 必须包含哪些字段。
- 列出需要链接的内部笔记。
- 明确是否需要 embeds 或 callouts。
- 要求只使用有效的 Obsidian 语法。
示例：
“Using the obsidian-markdown skill, draft a project note for a knowledge base. Include YAML frontmatter with title, tags, status, and aliases; use wikilinks to [[Roadmap]] and [[Open Questions]]; add one > [!tip] callout and one note embed.”
这比普通提示词更有效，因为它同时收紧了语法范围和内容结构。
提升输出质量的实用工作流
使用 obsidian-markdown guide 时，建议分两轮完成：
- 第一轮：先让模型生成笔记结构、frontmatter、链接和 callouts。
- 第二轮：再根据你 vault 中的真实内容，细化命名、tags 和 embeds。
另外要先确认，模型应该使用 vault 内部链接，还是外部 Markdown 链接。这个 skill 明确区分了用于 vault 笔记的 [[wikilinks]] 和用于 URL 的标准链接。这个单独的选择会直接影响长期可维护性，因为 Obsidian 会跟踪 wikilinks 的重命名。
obsidian-markdown skill 常见问题
obsidian-markdown 比普通 Markdown 提示词更好吗？
如果你的目标是让输出在 Obsidian 里正确渲染，那答案是肯定的。通用提示词经常会漏掉 frontmatter 格式、在更适合用 wikilinks 的地方使用普通链接，或者编造并不受支持的 callout 写法。obsidian-markdown skill 可以减少这些后续清理工作。
这个 skill 对新手友好吗？
友好，但前提主要是你已经知道自己想要哪种笔记。你不需要熟悉 Obsidian 的每个功能，因为参考文件已经展示了有效语法。新手仍然需要提供的是“意图”：这篇笔记是做什么用的、哪些 metadata 很重要、以及它应该连接到哪些已有笔记。
什么情况下 obsidian-markdown 不适合你？
如果你的工作流使用平台无关的 Markdown、主要发布到 GitHub 或静态站点生成器，或者你根本不用 Obsidian 特有语法，那就可以跳过它。这个 skill 覆盖的是 Obsidian 扩展语法，不是通用写作质量优化，也不是 PKM 系统设计工具。
它适合更大的知识库工作流吗？
适合。obsidian-markdown for Knowledge Bases 在你需要跨大量笔记保持一致性时尤其有用。它能帮助统一 frontmatter、内部链接方式和可复用的 callout 模式。它关注的重点不是一次性的写作，而是产出在 vault 内部能稳定正确运作的笔记。
如何改进 obsidian-markdown skill
提供更强的 vault 专属约束
提升 obsidian-markdown 结果质量最快的方法，就是给出真实的 vault 上下文。包括准确的笔记名称、偏好的 property key、tag 格式，以及 embeds 是否应指向标题或 block ID。如果缺少这些信息，模型即使生成了语法正确的内容，也可能和你的 vault 规范不一致。
留意常见失败模式
常见问题包括：
- 错误混用 Markdown links 和 wikilinks
- YAML frontmatter 格式不合法
- 使用 callouts 时没有正确套用 block quote 格式
- 引用的 embeds 与真实文件名不匹配
- 编造了你的 vault 实际并不用的 properties
这些通常不算 skill 本身的重大缺陷，更多是因为提示词约束不够明确。
第一稿后继续迭代
拿到第一版输出后，优先要求定向修正，而不是整篇重写。比较有效的后续指令包括：
- “Convert all internal links to wikilinks.”
- “Normalize tags to nested format.”
- “Replace generic quote blocks with supported Obsidian callouts.”
- “Move metadata into frontmatter and keep body content clean.”
这样可以让 obsidian-markdown usage 工作流更高效，也能避免在大范围重新生成时，把原本已经正确的语法一起弄丢。
针对你的环境提升这个 skill 的实际价值
如果你经常依赖这个 skill，可以自己做一个 prompt wrapper，里面固定包含：
- 你的标准 frontmatter schema
- 偏好的 callout types
- 常用 note templates
- 文件名和 aliases 的命名规则
这样一来，obsidian-markdown install 带来的就不只是一次性的语法辅助，而会变成你 vault 中可重复使用的笔记生成层。