obsidian-markdown

技能简介

本技能用于创建和编辑 Obsidian 专属的 Markdown 语法（Obsidian Flavored Markdown），包括 wikilinks、embeds、callouts、properties 等扩展语法。它帮助你在 Obsidian 中正确书写笔记文件，确保内容在阅读视图中正常渲染。

使用场景

• 在 Obsidian 中创建或编辑 .md 笔记文件。
• 需要生成内部链接（wikilinks）或嵌入其他笔记、图片、PDF 内容。
• 使用 callouts 突出提示、警告、示例等块级信息。
• 编辑 frontmatter（属性）为笔记添加标签、别名、CSS 类等元数据。
• 处理涉及 tags、embeds、properties 等 Obsidian 专属语法时的写作任务。

使用方法

本技能通常由 Agent 直接调用，无需额外安装。使用时，将技能目录放入 Agent 的 skills 路径即可启用。

主要遵循以下工作流：

1. 在文件开头添加 frontmatter，定义标题、标签、别名等属性。
2. 使用标准 Markdown 编写正文结构，并配合 Obsidian 扩展语法。
3. 使用 [[笔记名]] 连接库内笔记，使用 [文字](URL) 连接外部链接。
4. 使用 ![[嵌入内容]] 嵌入笔记、图片、PDF 等。
5. 使用 > [!类型] 添加 callout 高亮信息。
6. 在阅读视图预览确认渲染正常。

常用语法示例：

[[笔记名|显示文字]]          # 带别名的内部链接
![[图片.png|300]]           # 嵌入图片并设置宽度
> [!warning] 自定义标题      # 自定义标题的警告框
%% 注释内容 %%               # 阅读视图中隐藏的注释
==高亮文本==                 # 高亮标记

注意事项

• 内部链接优先使用 [[wikilinks]]，因为 Obsidian 会自动跟踪重命名；外部 URL 才用 [text](url)。
• frontmatter 中 tags 可用于可搜索标签，aliases 可提供备选笔记名，cssclasses 可添加自定义样式类。
• 列表和引用块添加块 ID 时，需将 ^id 放在块之后单独一行。
• Mermaid 节点若要链接到笔记，需添加 class NodeName internal-link;。