让 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 帮你规划知识点之间的逻辑连接。
核心工作流
- 配置属性面板 (Frontmatter):在文件顶部创建 YAML 区域,定义
title、tags和aliases。 - 构建内部关联 (Wikilinks):使用
[[笔记名称]]创建库内链接,或使用[[笔记名称#标题]]定位到具体章节。 - 实现内容嵌入 (Embeds):在链接前加
!,实现笔记、图片或 PDF 页面在当前页的内联显示。 - 增强视觉引导 (Callouts):使用
> [!type]语法创建彩色信息块(如[!info]或[!warning])。 - 标记细节与元数据:利用
==高亮==、%%注释%%以及 Mermaid 流程图增强笔记表达力。
语法示例
---
title: 深度学习研究
tags: [AI, Research]
---
# 核心概念
这是一个关于 [[神经网络]] 的研究笔记。
> [!tip] 关键结论
> 学习率的调节对模型收敛至关重要。
## 相关资料
![[架构图.png|300]]
参考 [[优化算法#梯度下降]] 部分。
%% 记得在下周更新此部分 %%
下载和安装
下载 obsidian-markdown 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。
你可能还需要
暂无推荐