1实现原理 · 为什么它能做到

纯知识注入型技能：SKILL.md 把 Obsidian 方言 Markdown 的全部扩展语法写进模型上下文，模型据此写出合法的 .md——无脚本、无网络、无依赖。

skills/obsidian-markdown/SKILL.md

This skill enables skills-compatible agents to create and edit valid Obsidian Flavored Markdown, including all Obsidian-specific syntax extensions.

这里在做什么：定义技能边界为「Obsidian 方言 Markdown 的读写」。

先交代方言构成：CommonMark + GFM + LaTeX + Obsidian 专有扩展的叠加。

skills/obsidian-markdown/SKILL.md

Obsidian uses a combination of Markdown flavors:

这里在做什么：为后续每个语法块定位所属规范层。

内部链接用 wikilinks，支持标题、块引用、搜索链接与别名显示，且给出块 ID 定义方式。

skills/obsidian-markdown/SKILL.md

Define a block ID by adding `^block-id` at the end of a paragraph:

这里在做什么：把 [[Note#^id]] 与 ^id 定义配对讲清，是可链接块的关键。

Markdown 式链接要求空格 URL 编码为 %20，并支持 obsidian:// 协议。

skills/obsidian-markdown/SKILL.md

Note: Spaces must be URL-encoded as `%20` in Markdown links.

这里在做什么：点出与普通 Markdown 的差异细则。

嵌入语法覆盖笔记/图片/音频/PDF/列表/查询结果，并支持尺寸参数。

skills/obsidian-markdown/SKILL.md

![[image.png|640x480]] Width x Height

这里在做什么：用实例展示嵌入的尺寸写法。

Callout 有固定类型表（note/info/tip/warning 等 13 类）与别名，且支持折叠与嵌套。

skills/obsidian-markdown/SKILL.md

### Supported Callout Types

这里在做什么：把 callout 类型与别名、颜色、图标一次性给全。

属性（frontmatter）区分类型并列出默认字段 tags/aliases/cssclasses。

skills/obsidian-markdown/SKILL.md

Properties use YAML frontmatter at the start of a note:

这里在做什么：规范笔记元数据写法。

数学用 LaTeX（行内 $...$ / 块 $$...$$），图表用 Mermaid，另附完整综合示例。

skills/obsidian-markdown/SKILL.md

This is inline math: $e^{i\pi} + 1 = 0$

这里在做什么：覆盖学术笔记常用的数学与图表达能力。

2核心能力

01Wikilinks 内部链接：别名显示、标题/块定位、搜索链接

02块引用：^block-id 定义与 [[Note#^id]] 引用

03嵌入：笔记/图片(带尺寸)/音频/PDF(指定页)/列表/查询结果

04Callouts：13 种类型含别名、自定义标题、折叠与嵌套、自定义 CSS

05属性 frontmatter：类型区分与默认字段 tags/aliases/cssclasses

06数学（LaTeX 行内/块）、Mermaid 图（flowchart/sequence/internal-link）

07表格与对齐、转义竖线、代码块（含嵌套技巧）

08标签语法（嵌套/连字符/下划线）与注释、脚注、HTML 内容

4管控建议与判定依据

建议配套管控措施

面向 Agent

可自动加载

面向管理者

登记来源与版本

判定依据（文件路径与关键语句摘要）

SKILL.md: 纯提示词指令与规则文本，无脚本执行与外部影响

审计说明： 纯指令型：单文件 SKILL.md（621 行）全为语法规范，§3 扫描无脚本执行/网络请求/凭证读取/写盘，无危险旗标。目录仅一个文件。。

5第二遍独立确认

[ok] 文件面核对 — §1 仅 skills/obsidian-markdown/SKILL.md（10813 字节 / 621 行），无 scripts/references/assets。
[ok] URL 命中性质复核 — §3 的 14 条 URL：commonmark.org/gfm/latex 与 help.obsidian.md 为文档链接，example.com 两条为示例占位符；均非运行时调用。
[ok] 安全结论反例搜索 — §3 凭证/外部程序/写盘/网络请求/危险旗标全部无命中。
[ok] 能力是否夸大 — description 声明的 wikilinks/embeds/callouts/properties 在 §2 均有独立章节与示例。
[ok] 档位判定复核 — 纯指令单文件、无任何执行面 → 🟢 green 成立。