obsidian-markdown

Obsidian Markdown 规范

本 Skill 定义了知识库中所有 Markdown 文件必须遵循的 Obsidian Flavored Markdown 语法标准。标准 Markdown（标题、列表、粗体、代码块等） assumed knowledge，此处仅覆盖 Obsidian 特有扩展。

---

工作流：创建 Wiki 页面

1. 添加 frontmatter（YAML Properties）在文件最顶部
2. 编写正文使用标准 Markdown + 本规范中的 Obsidian 特有语法
3. 链接相关页面使用 wikilinks [[页面名]] 建立内部连接
4. 嵌入内容使用 ![[embed]] 引用图片、PDF 或其他笔记片段
5. 使用 callouts高亮关键信息
6. 验证页面在 Obsidian 阅读视图中渲染正确

链接选择原则：Vault 内部页面一律使用 [[wikilinks]]（Obsidian 会自动追踪重命名），外部 URL 才使用标准 Markdown 链接 [text](url)。

---

1. 内部链接（Wikilinks）

[[页面名称]]                    → 基础链接
[[页面名称|显示文本]]           → 自定义显示文本
[[页面名称#标题]]               → 链接到目标页面的某个标题
[[页面名称#^块ID]]              → 链接到目标页面的某个段落（块）
[[#本文标题]]                   → 同一页面内的标题跳转

块 ID（Block ID）

在任意段落末尾追加 ^块ID 即可创建可链接的块：

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

对于列表和引用块，块 ID 放在块后面的独立行：

> 这是一个引用块

^quote-id

引用时：

[[某页面#^quote-id]]

---

2. 嵌入（Embeds）

在 wikilink 前加 ! 即可嵌入内容：

![[页面名称]]                  → 嵌入整页内容
![[页面名称#标题]]             → 嵌入某个标题下的内容
![[页面名称#^块ID]]            → 嵌入某个段落
![[图片.png]]                  → 嵌入图片
![[图片.png|300]]              → 嵌入图片并限制宽度为 300px
![[图片.png|640x480]]          → 嵌入图片并指定宽高
![[文档.pdf#page=3]]           → 嵌入 PDF 的第 3 页
![[文档.pdf#height=400]]       → 嵌入 PDF 并限制高度
![[音频.mp3]]                  → 嵌入音频播放器

外部图片：

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

---

3. Callouts

> [!note]
> 基础笔记 callout

> [!warning] 自定义标题
> 带自定义标题的警告 callout

> [!faq]- 默认折叠
> 默认折叠的 callout（- 折叠，+ 展开）

> [!tip]+
> 默认展开但可折叠的 callout

支持的 Callout 类型

类型	别名	语义
note	—	一般笔记
abstract	summary, tldr	摘要/总结
info	—	信息
todo	—	待办事项
tip	hint, important	提示/重要
success	check, done	成功/完成
question	help, faq	问题/帮助
warning	caution, attention	警告
failure	fail, missing	失败
danger	error	危险/错误
bug	—	Bug
example	—	示例
quote	cite	引用