Obsidian 扩展语法

Obsidian 除了支持之前所说的 Markdown 基本语法，还有一些基于链接，和应用笔记，为了更方便产出而设置支持的扩展集。

标签（tag）

标签是一个组织大量笔记的好方法，它能让你更容易找到笔记。标签本质上是一个可点击的检索按钮，点击它 Obsidian 就会自动为你搜索包含这个标签的笔记。比如，点击 #标签 这个标签后，Obsidian 将会显示库中所有包含这个标签的笔记。标签有各种不同的用法，比如标明笔记的来源或是笔记的种类。Zettelkasten 方法的使用者则会将标签作为连接笔记、连接想法的“切入点”。

具体可参考 标签的使用

可使用的字符

标签中不允许使用空格。所以，如果你想区分标签中的词语，你可以使用以下格式：

• 使用驼峰式大小写: #TwoWords
• 使用下划线： #two_words
• 使用连字符： #two-words

总的来说，标签只允许以下符号：

1. _ 下划线和 - 连字符号
2. 用于 标签的使用#嵌套标签 的 / 斜杠

笔记内容引用

引用笔记内容到文本

![[笔记文件名#标题名]]    引用具体笔记某个标题下的全部内容
![[笔记文件名^文本块]]    引用具体笔记下某个文本块的内容
[[笔记文件名#标题名]]    链接具体笔记某个标题
[[笔记文件名^文本块]]    链接具体笔记某个文本块
[[笔记文件名^文本块|显示别名]]    链接具体笔记某个文本块，并显示别名

自定义图片大小

以下方式都是允许的：

• ![AltText|100x100](https://url/to/image.png)，引用网络图片，并做裁剪，指定宽高
• ![AltText|100](https://url/to/image.png)，引用网络图片，指定宽度，图片按照宽度缩放
• ![[image.png|100x100]]，对本地图片（仓库中）宽度高度都做裁剪
• ![[image.png|100]]，对本地图片（仓库中）并指定宽度，图片按照宽度缩放

或者这样表述你更你更理解：

• ![图片名称|宽度数值](链接地址)，引用网络图片，并做裁剪
• ![[图片名|宽度数值]]，对本地图片（仓库中）宽度高度都做裁剪

Callout

你可以参考英文原版，了解这个功能：Use callouts，也可以阅读下面的中文简要说明

在笔记中直接书写（无需代码块）如下内容：

> [!规定的标记]

这里规定的标记在对应的文章中查找，标记和样式是对应的。

如果可以输入标题，则这样：

> [!规定的标记] 标题内容

如果还可以输入内容：

> [!规定的标记] 标题内容
> 笔记内容，你会发现和 markdown 中的引用是相同的语法
>
> 比如分段也是这样空一行

目前支持的样式列表

官方示例

除了 info 类型还支持以下类型

• note
• abstract, summary, tldr
• info, todo
• tip, hint, important
• success, check, done
• question, help, faq
• warning, caution, attention
• failure, fail, missing
• danger, error
• bug
• example
• quote, cite

提示框的各种用法

• 可以没有内容直接显示标题

• 折叠提示框

自定义提示框

可以通过 css 设置 my-callout-type 的样式

.callout[data-callout="my-callout-type"] {
    --callout-color: 0, 0, 0;
    --callout-icon: icon-id;
    --callout-icon: '<svg>...custom svg...</svg>';
}

居右对其

扩充 Callouts 的语法，在 Callout 类型后上 Pipe，再輸入下列设定：

扩展阅读

视频教程

基础优化

自定义美化

键盘文本也不一定非得是键盘按键，也可以作为着重文本突出显示。一般适合你要描述快捷键，按键有关的时候，推荐使用，当然使用其他强化语法也是可以的。

键盘文本的格式

• <kbd>键盘文本</kbd>
• <kbd>Ctrl</kbd> + <kbd>X</kbd>
• 效果： Ctrl + X

加粗键盘文本

• 加粗键盘文本的格式有两种：
• <kbd>**键盘文本**</kbd>
• **<kbd>ctrl + x</kbd>**
• 效果： ctrl + x

如何插入视频和音频

以插入 B 站视频为例

1. 找到 B 站相关视频，然后点击分享
2. 复制嵌入代码 例子：

<iframe src="//player.bilibili.com/player.html...." scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

1. 修改嵌入代码为：

<iframe src="http://player.bilibili.com/player.html..." scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

在 src=“ 后增加 http:

1. 将修改后的嵌入代码复制到 obsidian，执行预览看效果

Emoji 符号

用一对 : 包裹，里面是 Emoji 符号的 语义化文本

• 示例：
• :smile``:sweat``:cat``:woman_cartwheeling
  • 效果： 😀 😅 😺 👩 🤸‍♀️

补充

• 不支持上述方式的 MD 编辑器或笔记软件，直接用 输入法 输入也是可以的
• Windows 系统 用户 win + . 就可以输入 Emoji 了
• Obsidian 用户可以安装第三方插件来支持 Emoji 的输入，推荐：

1. obsidian-emoji-toolbar
2. emoji-shortcodes
3. obsidian-icon-shortcodes

注释语法

Markdown 的  注释  和  HMTL  一样，注释的内容在  渲染界面 不可见 （部分编辑器可见)

注释 的格式：

• <!-- 这里是注释的内容 -->
• 注释可以是单行，也可以是多行
• 如果有在使用  Obsidian  的，它的注释格式是不一样的
• %%这是Obsidian的注释内容%%

<!-- 这里是一行注释 -->

<!--
这里是
一段
假装有
很多行的
注释
-->

%%这是一行Obsidian里的注释%%

%%
这里是
一段
假装有
很多行的
Obsidian里的
注释
%%

示范 (只有切换至 编辑模式 才能看到喔)

%% 这是一行 Obsidian 里的注释%%

%% 这里是 一段 假装有 很多行的 Obsidian 里的 注释 %%

视频教程

讨论

若阁下有独到的见解或新颖的想法，诚邀您在文章下方留言，与大家共同探讨。