obsidian-markdown

obsidian-markdown 技能使 AI 代理能够在 Obsidian 知识库中生成、格式化和操作笔记，并运用其专属语法。此技能专为依赖 Obsidian 生态系统维护知识网络的知识工作者、研究人员及写作者所设计。通过区分标准 CommonMark/GFM 与 Obsidian 特有扩展功能，代理可以有效地管理知识库文件、内部参照与结构化元数据。此技能对于维护 Obsidian 内部的双向链接与视觉组织功能至关重要。

• 完整支持维基链接 (wikilink) 语法，包括 [[笔记名称]]、[[笔记名称|显示文字]]、标题链接以及通过 ^block-id 进行区块层级引用。

• 先进的嵌入功能，可使用 ![[链接]] 语法嵌入图像、PDF、音频、视频及其他笔记内容。

• 通过 YAML 前置元数据 (properties) 进行结构化数据管理，支持文字、数字、日期、列表及布尔复选框等类型。

• 利用提示框 (callouts) 进行区块样式设计，支持 note、tip、warning、danger 及 success 等多种类型，以提升笔记易读性。

• 整合 LaTeX 数学公式、Mermaid 图表绘制，以及用于内部备忘的隐藏注释功能。

• 包含高亮文字、嵌套标签及复杂脚注等格式扩展功能。

• 对于知识库内部的链接，请优先使用维基链接 ([[...]])，以便利用 Obsidian 的自动重命名与链接追踪功能。

• 标准 Markdown 链接 文字 仅限用于外部网址，以区分本地知识库结构与网络资源。

• 在建立笔记时，请在文件顶部包含前置元数据，定义 tags、aliases 与 status 等关键属性，确保笔记能在关系图中被发现。

• 若使用 Mermaid 图表或嵌套提示框等复杂嵌入内容，请务必保持正确的缩排与语法，以确保在 Obsidian 的阅读模式下能正常呈现。

• 本技能预设使用者具备标准 Markdown 基础，专注于处理将纯文本文件转变为网络化知识体的“Obsidian 风格”层级。