关于
创建和编辑 Obsidian 风格 Markdown，支持 Wikilinks、嵌入、Callouts、属性和其他 Obsidian 特有语法。适用于在 Obsidian 中处理 .md 文件。
name: obsidian-markdown description: 创建和编辑 Obsidian 风格的 Markdown，包括 wikilinks、嵌入、标注、属性和其他 Obsidian 特有语法。适用于在 Obsidian 中处理 .md 文件，或用户提到 wikilinks、标注、frontmatter、标签、嵌入或 Obsidian 笔记时使用。 risk: unknown source: "https://github.com/kepano/obsidian-skills" date_added: "2026-03-21"
Obsidian 风格 Markdown 技能
创建和编辑有效的 Obsidian 风格 Markdown。Obsidian 在 CommonMark 和 GFM 基础上扩展了 wikilinks、嵌入、标注、属性、注释和其他语法。本技能仅涵盖 Obsidian 特有的扩展——标准 Markdown（标题、粗体、斜体、列表、引用、代码块、表格）为默认知识。
适用场景
- 编写或编辑用于 Obsidian 的 Markdown 笔记时使用。
- 任务涉及 wikilinks、嵌入、标注、frontmatter 属性或 Obsidian 特有语法时使用。
- 用户希望笔记在 Obsidian 仓库中正确渲染时使用。
工作流程：创建 Obsidian 笔记
- 添加 frontmatter，在文件顶部设置属性（标题、标签、别名）。所有属性类型详见 PROPERTIES.md。
- 编写内容，使用标准 Markdown 构建结构，加上下方的 Obsidian 特有语法。
- 链接相关笔记，使用 wikilinks（
[[笔记]]）进行仓库内部连接，或使用标准 Markdown 链接连接外部 URL。 - 嵌入内容，从其他笔记、图片或 PDF 中嵌入内容，使用
![[嵌入]]语法。所有嵌入类型详见 EMBEDS.md。 - 添加标注，使用
> [!type]语法高亮显示信息。所有标注类型详见 CALLOUTS.md。 - 验证笔记在 Obsidian 阅读视图中正确渲染。
在 wikilinks 和 Markdown 链接之间选择时：对仓库内的笔记使用
[[wikilinks]]（Obsidian 会自动跟踪重命名），仅对外部 URL 使用普通 Markdown 链接。
内部链接（Wikilinks）
[[笔记名称]] 链接到笔记
[[笔记名称|显示文本]] 自定义显示文本
[[笔记名称#标题]] 链接到标题
[[笔记名称#^block-id]] 链接到块
[[#同一笔记中的标题]] 同笔记标题链接
通过在任意段落末尾添加 ^block-id 来定义块 ID：
这个段落可以被链接到。 ^my-block-id
对于列表和引用，将块 ID 放在块之后的单独一行：
> 一段引用
^quote-id
嵌入
在任何 wikilink 前加 ! 即可内联嵌入其内容：
![[笔记名称]] 嵌入完整笔记
![[笔记名称#标题]] 嵌入章节
![[image.png]] 嵌入图片
![[image.png|300]] 嵌入指定宽度的图片
![[document.pdf#page=3]] 嵌入 PDF 页面
音频、视频、搜索嵌入和外部图片详见 EMBEDS.md。
标注
> [!note]
> 基本标注。
> [!warning] 自定义标题
> 带自定义标题的标注。
> [!faq]- 默认折叠
> 可折叠标注（- 折叠，+ 展开）。
常用类型：note、tip、warning、info、example、quote、bug、danger、success、failure、question、abstract、todo。
完整列表（含别名、嵌套和自定义 CSS 标注）详见 CALLOUTS.md。
属性（Frontmatter）
---
title: 我的笔记
date: 2024-01-15
tags:
- project
- active
aliases:
- 替代名称
cssclasses:
- custom-class
---
默认属性：tags（可搜索标签）、aliases（笔记的替代名称，用于链接建议）、cssclasses（用于样式的 CSS 类）。
所有属性类型、标签语法规则和高级用法详见 PROPERTIES.md。
标签
#tag 内联标签
#nested/tag 带层级的嵌套标签
标签可包含字母、数字（不能作为首字符）、下划线、连字符和正斜杠。标签也可以在 frontmatter 的 tags 属性中定义。
注释
这是可见的 %%但这是隐藏的%% 文本。
%%
这整个块在阅读视图中是隐藏的。
%%
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;。
脚注
带脚注的文本[^1]。
[^1]: 脚注内容。
内联脚注。^[这是内联的。]
完整示例
---
title: 项目 Alpha
date: 2024-01-15
tags:
- project
- active
status: in-progress
---
# 项目 Alpha
本项目使用 Obsidian 进行知识管理。详见 [[项目概述]] 了解更多信息。
> [!tip] 快速开始
> 查看 [[入门指南]] 开始使用。
## 相关笔记
- [[会议记录]]
- [[技术文档#架构设计]]
![[项目时间线.png|500]]