⚡

ObsidianMarkdown技能Skill obsidian-markdown

Obsidian Markdown 技能是一个用于创建和编辑 Obsidian 笔记的工具，支持维基链接、标注、嵌入等特定语法，适用于知识管理、文档编写和笔记整理。关键词：Obsidian, Markdown, 笔记, 知识管理, 文档创作。

其他 0 次安装 0 次浏览 更新于 3/21/2026

name: obsidian-markdown description: 创建和编辑 Obsidian 风格 Markdown，包括维基链接、嵌入、标注、属性和其他 Obsidian 特定语法。当在 Obsidian 中处理 .md 文件，或用户提到维基链接、标注、前置属性、标签、嵌入或 Obsidian 笔记时使用。

Obsidian 风格 Markdown 技能

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

概述

Obsidian 使用多种 Markdown 变体的组合：

基本格式化

段落和换行

这是一个段落。

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

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

标题

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

文本格式化

样式 语法 示例 输出
粗体 **text** 或 __text__ **粗体** 粗体
斜体 *text* 或 _text_ *斜体* 斜体*
粗体 + 斜体 ***text*** ***两者** *两者
删除线 ~~text~~ ~~删除~~ 删除
高亮 ==text== ==高亮== ==高亮==
内联代码 `code` `代码` 代码

转义格式化

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

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

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

内部链接（维基链接）

基本链接

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

链接到标题

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

链接到块

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

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

这是一个可以链接的段落。 ^my-block-id

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

> 这是一个引用
> 多行

^quote-id

搜索链接

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

Markdown 风格链接

[显示文本](Note%20Name.md)
[显示文本](Note%20Name.md#Heading)
[显示文本](https://example.com)
[笔记](obsidian://open?vault=VaultName&file=Note.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:#project status:done
```

标注

基本标注

> [!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 |
|----------|----------|
| [[Link\|Display]] | ![[Image\|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: Hello Bob
    Bob-->>Alice: Hi Alice
```

图中链接

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

脚注

这句话有脚注[^1]。

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

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

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

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

注释

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

%%
这整个块隐藏。
阅读视图不出现。
%%

水平线

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

属性（前置属性）

属性使用 YAML 前置属性在笔记开头：

---
title: 我的笔记标题
date: 2024-01-15
tags:
  - project
  - important
aliases:
  - 我的笔记
  - 替代名称
cssclasses:
  - custom-class
status: in-progress
rating: 4.5
completed: false
due: 2024-02-01T14:30:00
---

属性类型

类型 示例
文本 title: 我的标题
数字 rating: 4.5
复选框 completed: true
日期 date: 2024-01-15
日期时间 due: 2024-01-15T14:30:00
列表 tags: [one, two] 或 YAML 列表
链接 related: "[[其他笔记]]"

默认属性

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

标签

#tag
#nested/tag
#tag-with-dashes
#tag_with_underscores

前置属性中：
---
tags:
  - tag1
  - nested/tag2
---

标签可包含：

  • 字母（任何语言）
  • 数字（非首字符）
  • 下划线 _
  • 连字符 -
  • 斜杠 /（用于嵌套）

HTML 内容

Obsidian 支持 Markdown 内 HTML：

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

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

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

完整示例

---
title: 项目 Alpha
date: 2024-01-15
tags:
  - project
  - active
status: in-progress
priority: high
---

# 项目 Alpha

## 概述

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

> [!important] 关键截止日期
> 第一个里程碑应于 ==January 30th==。

## 任务

- [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

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

参考