SuperAPI AI 工具集

obsidian-markdown

通用与其它

查看项目

更新于 10-16 02:37

技能介绍

用途:创建和编辑合法的 Obsidian Flavored Markdown。Obsidian 在 CommonMark 与 GFM 基础上扩展了 wikilink、嵌入、callout、属性、注释等语法;本技能只覆盖 Obsidian 专有扩展,标准 Markdown(标题、加粗、斜体、列表、引用、代码块、表格)视为已有知识。

主要能力:内部链接用 [[Note Name]],可加显示文本 [[Note Name|Display Text]]、链接标题 [[Note Name#Heading]]、链接块 [[Note Name#^block-id]]、同笔记标题 [[#Heading in same note]];块 ID 以 ^block-id 追加到段落,列表和引用则另起一行放置。嵌入以 ! 前缀实现,如 ![[Note Name]]、![[Note Name#Heading]]、![[image.png]]、![[image.png|300]]、![[document.pdf#page=3]]。Callout 用 > [!type] 语法,支持自定义标题与折叠(- 折叠、+ 展开),常见类型包括 note、tip、warning、info、example、quote、bug、danger、success、failure、question、abstract、todo。属性写在文件顶部 frontmatter,默认属性有 tags、aliases、cssclasses。标签支持 #tag 与 #nested/tag,可含字母、数字(非首字符)、下划线、连字符和斜杠。注释用 %%...%%。另有 ==高亮==、LaTeX 数学(行内 $...$、块 $$...$$)、Mermaid 图表、脚注等。

使用方式:先确认文件类型和目标操作,再按流程执行——添加 frontmatter 属性、用标准 Markdown 写结构并叠加 Obsidian 语法、用 wikilink 连接库内笔记、用嵌入引用其他笔记或图片 PDF、用 callout 突出信息,最后在 Obsidian 阅读视图中验证渲染。选择链接方式时,库内笔记用 [[wikilinks]](Obsidian 会自动跟踪重命名),外部 URL 用 text。

适用场景:在 Obsidian 库中编写、整理和互链笔记,构建带属性、标签、嵌入与提示框的知识库文档。

限制:仅覆盖 Obsidian 专有扩展,不讲解标准 Markdown 基础;更完整的属性类型、嵌入类型、callout 别名与嵌套、自定义 CSS callout 等细节需参考随附的 PROPERTIES.md、EMBEDS.md、CALLOUTS.md 文档。具体安装命令与收费信息暂未提供。