创建和编辑带有维基链接、嵌入、标注、属性和其他Obsidian特定语法的Obsidian风格Markdown。在Obsidian中处理.md文件时,或当用户提到维基链接、标注、前置内容、标签、嵌入或Obsidian笔记时使用。
Obsidian风格Markdown技能
创建和编辑有效的Obsidian风格Markdown。Obsidian通过维基链接、嵌入、标注、属性、注释和其他语法扩展了CommonMark和GFM。此技能仅涵盖Obsidian特定的扩展 - 标准Markdown(标题、粗体、斜体、列表、引用、代码块、表格)被视为已知知识。
工作流程:创建Obsidian笔记
- 添加带属性的前置内容(标题、标签、别名)在文件顶部。有关所有属性类型,请参阅PROPERTIES.md。
- 编写内容使用标准Markdown进行结构,加上下面的Obsidian特定语法。
- 链接相关笔记使用维基链接(
[[Note]])进行内部库连接,或使用标准Markdown链接用于外部URL。 - 嵌入内容使用
![[embed]]语法从其他笔记、图像或PDF嵌入内容。有关所有嵌入类型,请参阅EMBEDS.md。 - 添加标注使用
> [!type]语法突出显示信息。有关所有标注类型,请参阅CALLOUTS.md。 - 验证笔记在Obsidian的阅读视图中正确渲染。
在选择维基链接和Markdown链接之间:对库内的笔记使用[[维基链接]](Obsidian自动跟踪重命名),仅对外部URL使用[text](url)。
内部链接(维基链接)
[[Note Name]] 链接到笔记
[[Note Name|Display Text]] 自定义显示文本
[[Note Name#Heading]] 链接到标题
[[Note Name#^block-id]] 链接到块
[[#Heading in same note]] 同一笔记中的标题链接通过在任何段落后追加^block-id来定义块ID:
This paragraph can be linked to. ^my-block-id对于列表和引用,将块ID放在块后的单独行上:
> A quote block
^quote-id嵌入
在任何维基链接前加上!以内联嵌入其内容:
![[Note Name]] 嵌入完整笔记
![[Note Name#Heading]] 嵌入部分
![[image.png]] 嵌入图像
![[image.png|300]] 嵌入指定宽度的图像
![[document.pdf#page=3]] 嵌入PDF页面有关音频、视频、搜索嵌入和外部图像,请参阅EMBEDS.md。
标注
> [!note]
> Basic callout.
> [!warning] Custom Title
> Callout with a custom title.
> [!faq]- Collapsed by default
> Foldable callout (- collapsed, + expanded).常见类型:note、tip、warning、info、example、quote、bug、danger、success、failure、question、abstract、todo。
有关带有别名、嵌套和自定义CSS标注的完整列表,请参阅CALLOUTS.md。
属性(前置内容)
---
title: My Note
date: 2024-01-15
tags:
- project
- active
aliases:
- Alternative Name
cssclasses:
- custom-class
---默认属性:tags(可搜索标签)、aliases(链接建议的替代笔记名称)、cssclasses(用于样式的CSS类)。
有关所有属性类型、标签语法规则和高级用法,请参阅PROPERTIES.md。
标签
#tag 内联标签
#nested/tag 带层次结构的嵌套标签标签可以包含字母、数字(不是第一个字符)、下划线、连字符和正斜杠。标签也可以在前置内容中的tags属性下定义。
注释
This is visible %%but this is hidden%% text.
%%
This entire block is hidden in reading view.
%%Obsidian特定格式
==Highlighted text== 高亮语法数学(LaTeX)
内联:$e^{i\pi} + 1 = 0$
块:
$$
\frac{a}{b} = c
$$图表(Mermaid)
````markdown
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[Do this]
B -->|No| D[Do that]``
要将Mermaid节点链接到Obsidian笔记,添加class NodeName internal-link;。
脚注
Text with a footnote[^1].
[^1]: Footnote content.
Inline footnote.^[This is inline.]完整示例
````markdown
title: Project Alpha
date: 2024-01-15
tags:
- project
- active
status: in-progress
Project Alpha
This project aims to [[improve workflow]] using modern techniques.
[!important] Key Deadline
The first milestone is due on ==January 30th==.
Tasks
- [x] Initial planning
- [ ] Development phase
- [ ] Backend implementation
- [ ] Frontend design
Notes
The algorithm uses $O(n \log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.
![[Architecture Diagram.png|600]]
Reviewed in [[Meeting Notes 2024-01-10#Decisions]].
``
参考
兼容工具
站内相关工具
数据来源:obsidian-skills(MIT 许可) | 查看上游来源
上游项目:kepano/obsidian-skills / obsidian-skills | 收录时间:2026-08-18 | 更新:2026-08-18
本页面内容基于上游开源许可项目整理,仅供学习参考。AI铺子不对第三方内容承担责任, 详情请参阅免责声明。