名称: obsidian-markdown 描述: 创建和编辑 Obsidian 风格的 Markdown，包含 wikilinks、embeds、callouts、properties 和其他 Obsidian 特定语法。在处理 Obsidian 中的 .md 文件时使用，或当用户提到 wikilinks、callouts、frontmatter、tags、embeds 或 Obsidian 笔记时。

Obsidian 风格 Markdown 技能

这个技能使技能兼容代理能够创建和编辑有效的 Obsidian 风格 Markdown，包括所有 Obsidian 特定的语法扩展。

概述

Obsidian 使用多种 Markdown 风格的组合：

CommonMark
GitHub Flavored Markdown
LaTeX 用于数学
Obsidian 特定扩展（wikilinks、callouts、embeds 等）

基本格式化

段落和换行

这是一个段落。

这是另一个段落（空白行之间创建单独段落）。

对于段落内的换行，在末尾添加两个空格  
或使用 Shift+Enter。

标题

# 标题 1
## 标题 2
### 标题 3
#### 标题 4
##### 标题 5
###### 标题 6

文本格式化

样式	语法	示例	输出
粗体	`文本` 或 `__文本__`	`粗体`	粗体
斜体	`文本` 或 `_文本_`	`斜体`	斜体*
粗体 + 斜体	`*文本*`	`*两者`	*两者
删除线	`~~文本~~`	`~~删除**`	~~删除**
高亮	`==文本==`	`==高亮**`	==高亮**
内联代码	`代码`	`代码`	`代码`

转义格式化

使用反斜杠转义特殊字符：

\*这不会斜体*\*
\#这不会标题
1\. 这不会列表项

常见转义字符：\*, \_, \#, \`, \|, \~

内部链接（Wikilinks）

基本链接

[[笔记名称]]
[[笔记名称.md]]
[[笔记名称|显示文本]]

链接到标题

[[笔记名称#标题]]
[[笔记名称#标题|自定义文本]]
[[#同一笔记中的标题]]
[[##搜索所有库中的标题]]

链接到块

[[笔记名称#^块-id]]
[[笔记名称#^块-id|自定义文本]]

通过添加 ^块-id 到段落末尾定义块 ID：

这是一个可以链接到的段落。 ^我的块-id

对于列表和引用，在单独行添加块 ID：

> 这是一个引用
> 有多行

^引用-id

搜索链接

[[##标题]]     搜索包含“标题”的标题
[[^^块]]       搜索包含“块”的块

Markdown 风格链接

[显示文本](笔记%20名称.md)
[显示文本](笔记%20名称.md#标题)
[显示文本](https://example.com)
[笔记](obsidian://open?vault=库名称&file=笔记.md)

注意：空格必须在 Markdown 链接中 URL 编码为 %20。

嵌入

嵌入笔记

![[笔记名称]]
![[笔记名称#标题]]
![[笔记名称#^块-id]]

嵌入图像

![[image.png]]
![[image.png|640x480]]    宽 x 高
![[image.png|300]]        仅宽（保持纵横比）

外部图像

![替代文本](https://example.com/image.png)
![替代文本|300](https://example.com/image.png)

嵌入音频

![[audio.mp3]]
![[audio.ogg]]

嵌入 PDF

![[document.pdf]]
![[document.pdf#page=3]]
![[document.pdf#height=400]]

嵌入列表

![[笔记#^列表-id]]

其中列表已用块 ID 定义：

- 项目 1
- 项目 2
- 项目 3

^列表-id

嵌入搜索结果

```query
tag:#项目 status:完成
```

标注（Callouts）

基本标注

> [!note]
> 这是一个笔记标注。

> [!info] 自定义标题
> 这个标注有自定义标题。

> [!tip] 仅标题

可折叠标注

> [!faq]- 默认折叠
> 此内容隐藏直到展开。

> [!faq]+ 默认展开
> 此内容可见但可折叠。

嵌套标注

> [!question] 外部标注
> > [!note] 内部标注
> > 嵌套内容

支持的标注类型

类型	别名	描述
`note`	-	蓝色，铅笔图标
`abstract`	`summary`, `tldr`	青色，剪贴板图标
`info`	-	蓝色，信息图标
`todo`	-	蓝色，复选框图标
`tip`	`hint`, `important`	青色，火焰图标
`success`	`check`, `done`	绿色，勾号图标
`question`	`help`, `faq`	黄色，问号
`warning`	`caution`, `attention`	橙色，警告图标
`failure`	`fail`, `missing`	红色，X 图标
`danger`	`error`	红色，闪电图标
`bug`	-	红色，错误图标
`example`	-	紫色，列表图标
`quote`	`cite`	灰色，引用图标

自定义标注（CSS）

.callout[data-callout="custom-type"] {
  --callout-color: 255, 0, 0;
  --callout-icon: lucide-alert-circle;
}

列表

无序列表

- 项目 1
- 项目 2
  - 嵌套项目
  - 另一个嵌套
- 项目 3

* 星号也有效
+ 或加号

有序列表

1. 第一项
2. 第二项
   1. 嵌套编号
   2. 另一个嵌套
3. 第三项

1) 替代语法
2) 带括号

任务列表

- [ ] 未完成任务
- [x] 完成任务
- [ ] 带子任务的任务
  - [ ] 子任务 1
  - [x] 子任务 2

引用

> 这是一个块引用。
> 它可以跨多行。
>
> 并包括多个段落。
>
> > 嵌套引用也有效。

代码

内联代码

使用 `反引号` 用于内联代码。
使用双反引号用于 ``代码内部有 ` 反引号``。

代码块

```
纯代码块
```

```javascript
// 语法高亮代码块
function hello() {
  console.log("Hello, world!");
}
```

```python
# Python 示例
def greet(name):
    print(f"Hello, {name}!")
```

嵌套代码块

使用更多反引号或波浪号用于外部块：

````markdown
这是如何创建代码块：
```js
console.log("Hello")
```
````

表格

| 标题 1 | 标题 2 | 标题 3 |
|----------|----------|----------|
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |

对齐

| 左对齐 | 居中对齐 | 右对齐 |
|:---------|:--------:|---------:|
| 左对齐 | 居中 | 右对齐 |

在表格中使用管道符

用反斜杠转义管道符：

| 列 1 | 列 2 |
|----------|----------|
| [[链接\|显示]] | ![[图像\|100]] |

数学（LaTeX）

内联数学

这是内联数学： $e^{i\pi} + 1 = 0$

块数学

$$
\begin{vmatrix}
a & b \\
c & d
\end{vmatrix} = ad - bc
$$

常见数学语法

$x^2$             上标
$x_i$             下标
$\frac{a}{b}$     分数
$\sqrt{x}$        平方根
$\sum_{i=1}^{n}$  求和
$\int_a^b$        积分
$\alpha, \beta$   希腊字母

图表（Mermaid）

```mermaid
graph TD
    A[开始] --> B{决定}
    B -->|是| C[做这个]
    B -->|否| D[做那个]
    C --> E[结束]
    D --> E
```

序列图

```mermaid
sequenceDiagram
    Alice->>Bob: 你好 Bob
    Bob-->>Alice: 你好 Alice
```

在图表中链接

```mermaid
graph TD
    A[生物学]
    B[化学]
    A --> B
    class A,B internal-link;
```

脚注

这句话有脚注[^1]。

[^1]: 这是脚注内容。

你也可以使用命名脚注[^note]。

[^note]: 命名脚注仍显示为数字。

内联脚注也支持。^[这是一个内联脚注。]

注释

这是可见文本 %%但这是隐藏%% 文本。

%%
这整个块是隐藏的。
它不会出现在阅读视图中。
%%

水平线

---
***
___
- - -
* * *

属性（Frontmatter）

属性使用 YAML frontmatter 在笔记开头：

---
标题: 我的笔记标题
日期: 2024-01-15
标签:
  - 项目
  - 重要
别名:
  - 我的笔记
  - 替代名称
cssclasses:
  - 自定义类
状态: 进行中
评分: 4.5
完成: false
截止: 2024-02-01T14:30:00
---

属性类型

类型	示例
文本	`标题: 我的标题`
数字	`评分: 4.5`
复选框	`完成: true`
日期	`日期: 2024-01-15`
日期和时间	`截止: 2024-01-15T14:30:00`
列表	`标签: [一, 二]` 或 YAML 列表
链接	`相关: "[[其他笔记]]"`

默认属性

标签 - 笔记标签
别名 - 笔记的替代名称
cssclasses - 应用于笔记的 CSS 类

HTML 内容

Obsidian 在 Markdown 中支持 HTML：

<div class="custom-container">
  <span style="color: red;">彩色文本</span>
</div>

<details>
  <summary>点击展开</summary>
  隐藏内容在这里。
</details>

<kbd>Ctrl</kbd> + <kbd>C</kbd>

完整示例

---
标题: 项目 Alpha
日期: 2024-01-15
标签:
  - 项目
  - 活跃
状态: 进行中
优先级: 高
---

# 项目 Alpha

## 概述

这个项目旨在使用现代技术 [[改进工作流]]。

> [!important] 关键截止日期
> 第一个里程碑在 ==1月30日== 截止。

## 任务

- [x] 初始规划
- [x] 资源分配
- [ ] 开发阶段
  - [ ] 后端实现
  - [ ] 前端设计
- [ ] 测试
- [ ] 部署

## 技术笔记

主要算法使用公式 $O(n \log n)$ 进行排序。

```python
def process_data(items):
    return sorted(items, key=lambda x: x.priority)
```

## 架构

```mermaid
graph LR
    A[输入] --> B[处理]
    B --> C[输出]
    B --> D[缓存]
```

## 相关文档

- ![[会议笔记 2024-01-10#决定]]
- [[预算分配|预算]]
- [[团队成员]]

## 参考文献

更多详情，见官方文档[^1]。

[^1]: https://example.com/docs

%%
内部笔记：
- 周五与团队审查
- 考虑替代方法
%%