让 AI 熟练编写 Obsidian 专属 Markdown 语法

解决 AI 生成内容与 Obsidian 渲染不匹配的问题:通过设定 Obsidian 特有语法规范,让 AI 能够自动生成包含双向链接、嵌入内容、彩色呼出块及 YAML 属性的专业笔记。

为什么需要这个技能

标准的 Markdown(如 GFM)在处理简单的文档时足够,但 Obsidian 的强大之处在于其“知识图谱”能力。它扩展了标准语法,引入了双向链接(Wikilinks)、嵌入(Embeds)和属性(Properties)等特性。

如果直接让 AI 写 Markdown,它通常只提供基础格式。而使用本技能后,AI 将知道在笔记顶部添加 YAML 属性以方便检索,使用 [[ ]] 代替传统链接以维护库内关联,并利用 Callouts 增强信息的视觉层级,使生成的笔记无需手动修改即可直接投入使用。

适用场景

  • 构建个人知识库:让 AI 将碎片化信息直接整理成符合 Obsidian 规范的 .md 文件。
  • 自动化笔记生成:将阅读摘要、会议记录自动转化为带有标签和属性的结构化笔记。
  • 复杂文档排版:需要使用 Callouts(如警告、提示、FAQ)来增强笔记的可读性。
  • 跨笔记联动:利用双链和块引用,让 AI 帮你规划知识点之间的逻辑连接。

核心工作流

  1. 配置属性面板 (Frontmatter):在文件顶部创建 YAML 区域,定义 titletagsaliases
  2. 构建内部关联 (Wikilinks):使用 [[笔记名称]] 创建库内链接,或使用 [[笔记名称#标题]] 定位到具体章节。
  3. 实现内容嵌入 (Embeds):在链接前加 !,实现笔记、图片或 PDF 页面在当前页的内联显示。
  4. 增强视觉引导 (Callouts):使用 > [!type] 语法创建彩色信息块(如 [!info][!warning])。
  5. 标记细节与元数据:利用 ==高亮==%%注释%% 以及 Mermaid 流程图增强笔记表达力。

语法示例

---
title: 深度学习研究
tags: [AI, Research]
---

# 核心概念

这是一个关于 [[神经网络]] 的研究笔记。

> [!tip] 关键结论
> 学习率的调节对模型收敛至关重要。

## 相关资料
![[架构图.png|300]]
参考 [[优化算法#梯度下降]] 部分。

%% 记得在下周更新此部分 %%

下载和安装

下载 obsidian-markdown 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md

你可能还需要

暂无推荐