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风险提醒 风险提醒：绿色 · 放心使用
风险提醒：绿色 · 放心使用
- 不校验产物，正确性依赖模型遵循度。 — 无 lint/validator；错误 wikilink 或 frontmatter 可能被直接写入 vault。
- 示例含占位 URL（example.com），照抄可能产生死链。 — §3 命中两条 example.com（链接与图片示例），属占位符。
- Obsidian 扩展随版本演进，技能未锚定版本。 — callouts/properties 等语法由 Obsidian 维护，技能文本可能滞后。
纯指令型：单文件 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 成立。
6结论
适合：在 Obsidian 中撰写/编辑笔记的用户：需要 wikilinks、callouts、frontmatter、嵌入、数学与 Mermaid 的规范写法；把 Obsidian 方言作为知识注入以避免语法错误。
不适合：非 Obsidian 的 Markdown 场景（普通 GFM/CommonMark 无需本技能）；需要技能直接渲染或预览产物的场合；对上游最新语法同步要求高的场景。
安装 agent 直装可复制
① 本站镜像 更新 2026-10-10
方式 A · 人下载镜像包下载 obsidian-markdown.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent0fe5017b220b50e4…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库freestylefly / freestylefly/canghe-skills
原始 GitHubfreestylefly/canghe-skills ↗
本 skill commit
dd0bf35595许可MIT（仓库根 LICENSE）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。