SuperAPI AI 工具集

obsidian-markdown

写作与研究

查看项目

更新于 10-16 05:07

技能介绍

用途:该技能教代理掌握完整的 Obsidian Flavored Markdown 规范,即 Obsidian 在标准 CommonMark 与 GitHub Flavored Markdown 之上扩展的语法。它假定已掌握标准 Markdown,只覆盖 Obsidian 专有部分,是所有 Obsidian 相关工作的基础,obsidian-links、obsidian-frontmatter、obsidian-note-builder 等技能均建立在其之上。

适用时机:用户要求创建或编辑 Obsidian 笔记、用 [[wikilink]] 建立笔记链接、嵌入其他笔记/图片/PDF、添加 callout、设置 frontmatter 属性(tags、aliases、cssclasses、自定义字段)、链接到特定标题或块,或代理生成将放入 Obsidian vault 的 .md 文件时使用。若为 GitHub、博客等非 Obsidian 场景生成 Markdown,或需校验链接目标是否存在、规范 frontmatter 格式,则应改用其他专门技能。

主要能力:文档说明了 frontmatter(YAML 置于文件最顶部,tags/aliases/cssclasses 须用带 - 的列表格式,禁用内联数组)、wikilink 写法([[笔记名]]、[[笔记名|显示文本]]、[[笔记名#标题]]、[[笔记名#^块ID]]、[[#本笔记标题]])、嵌入(wikilink 前加 !,可嵌入整篇、章节、块、图片、PDF 及指定 PDF 页)、callout(基于块引用,支持自定义标题、+/- 展开折叠、嵌套)、块 ID(仅字母数字连字符,需唯一)、内联标签与嵌套标签、注释 %%...%%、高亮 ==...==、LaTeX 数学、Mermaid 图、脚注等。

限制:不应用于非 Obsidian 的 Markdown 场景;不能校验链接目标是否存在;不得发明可能不存在的 wikilink 目标;块 ID 重复会导致静默链接失败;内部笔记必须用 wikilink,外部 URL 必须用标准 Markdown 链接,不可混用。原文未提供收费、价格、平台要求等信息。