| name | obsidian-markdown |
| description | 创建和编辑 Obsidian Flavored Markdown，支持 wikilinks、embeds、callouts、properties 及其他 Obsidian 特有语法。当处理 Obsidian 中的 .md 文件，或用户提到 wikilinks、callouts、frontmatter、tags、embeds 或 Obsidian 笔记时使用。 |
Obsidian Flavored Markdown 技能
创建和编辑合法的 Obsidian Flavored Markdown。Obsidian 在 CommonMark 和 GFM 基础上扩展了 wikilinks、embeds、callouts、properties、comments 等语法。本技能仅涵盖 Obsidian 特有扩展——标准 Markdown（标题、加粗、斜体、列表、引用、代码块、表格）视为已知知识。
工作流：创建 Obsidian 笔记
- 添加 frontmatter，在文件顶部包含属性（title、tags、aliases）。所有属性类型见 PROPERTIES.md。
- 撰写内容，使用标准 Markdown 组织结构，辅以下方的 Obsidian 特有语法。
- 关联相关笔记，使用 wikilinks（
[[笔记名]]）建立 vault 内部连接；外部 URL 使用标准 Markdown 链接。
- 嵌入内容，使用
![[embed]] 语法从其他笔记、图片或 PDF 嵌入内容。所有嵌入类型见 EMBEDS.md。
- 添加 callouts，使用
> [!type] 语法高亮展示信息。所有 callout 类型见 CALLOUTS.md。
- 验证笔记在 Obsidian 阅读视图下正确渲染。
在 wikilinks 和 Markdown 链接之间选择时：vault 内部笔记使用 [[wikilinks]]（Obsidian 自动追踪重命名），仅对外部 URL 使用 [text](url)。
内部链接（Wikilinks）
[[笔记名]] 链接到笔记
[[笔记名|显示文本]] 自定义显示文本
[[笔记名#标题]] 链接到标题
[[笔记名#^block-id]] 链接到块
[[#同笔记内的标题]] 同笔记内标题链接
在任意段落后追加 ^block-id 来定义块 ID：
这段话可以被链接。^my-block-id
对于列表和引用，将块 ID 放在块之后的单独一行：
> 一段引用
^quote-id
嵌入（Embeds）
在任何 wikilink 前加 ! 即可将其内容内联嵌入：
![[笔记名]] 嵌入完整笔记
![[笔记名#标题]] 嵌入章节
![[image.png]] 嵌入图片
![[image.png|300]] 嵌入图片并指定宽度
![[document.pdf#page=3]] 嵌入 PDF 指定页
音频、视频、搜索嵌入和外部图片见 EMBEDS.md。
Callouts
> [!note]
> 基本 callout。
> [!warning] 自定义标题
> 带自定义标题的 callout。
> [!faq]- 默认折叠
> 可折叠 callout（- 折叠，+ 展开）。
常用类型：note、tip、warning、info、example、quote、bug、danger、success、failure、question、abstract、todo。
完整类型列表（含别名、嵌套和自定义 CSS callouts）见 CALLOUTS.md。
属性（Frontmatter）
---
title: 我的笔记
date: 2024-01-15
tags:
- project
- active
aliases:
- 别名
cssclasses:
- custom-class
---
默认属性：tags（可搜索标签）、aliases（笔记的替代名称，用于链接建议）、cssclasses（应用于笔记的 CSS 类）。
所有属性类型、标签语法规则和高级用法见 PROPERTIES.md。
标签（Tags）
#tag 内联标签
#nested/tag 带层级的嵌套标签
标签可包含字母、数字（不能作为首字符）、下划线、连字符和正斜杠。标签也可以在 frontmatter 的 tags 属性中定义。
注释（Comments）
这是可见文字 %%但这是隐藏的%% 更多可见文字。
%%
这个整块在阅读视图中隐藏。
%%
Obsidian 特有格式
==高亮文本== 高亮语法
数学公式（LaTeX）
行内：$e^{i\pi} + 1 = 0$
块级：
$$
\frac{a}{b} = c
$$
图表（Mermaid）
```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[执行此操作]
B -->|否| D[执行那个操作]
```
要将 Mermaid 节点链接到 Obsidian 笔记，添加 class NodeName internal-link;。
脚注（Footnotes）
带脚注的文本[^1]。
[^1]: 脚注内容。
行内脚注。^[这是行内脚注。]
完整示例
---
title: 项目 Alpha
date: 2024-01-15
tags:
- project
- active
status: in-progress
---
# 项目 Alpha
本项目旨在用现代技术[[改进工作流]]。
> [!important] 关键截止日期
> 首个里程碑截止于 ==1月30日==。
## 任务
- [x] 初始规划
- [ ] 开发阶段
- [ ] 后端实现
- [ ] 前端设计
## 笔记
算法使用 $O(n \log n)$ 排序。详见 [[算法笔记#排序]]。
![[架构图.png|600]]
已在 [[会议纪要 2024-01-10#决策]] 中评审。
参考
