开始使用

这里，我们讲解通过创建并启动 URI 来打开笔记的完整的工作流。

创建 URI

收集参数

假设我们想要打开文件Home Index/today.md。通过查看 操作导航 得知我们唯一需要的参数是一个文件的 识别符。因此我们我们可以使用filepath参数来创建一个新的文件。

如你所见，我们的文件地址包括了一个空格和一个斜线。因此，我们必须对特殊符号进行 编码。通过在 在线 url 编码 输入Home Index/today（你可以忽略掉文件的拓展名），你获得了Home%20Index%2Ftoday的输出。现在我们有了参数键filepath和参数值Home%20Index%2Ftoday。

构建 URI

如 架构 中所述，每个 URI 都必须以 obsidian://advanced-uri开头。有关更详细的说明，请参阅 架构。我们最终得到的 URI 如下所示。

obsidian://advanced-uri?filepath=Home%20Index%2Ftoday

启动 URI

有很多种启动 URI 的方式。我仅仅列出最常见的部分

浏览器

你可以简单的在搜索栏输入 URI。他将询问你是否拉起外部应用。

Obsidian 内部链接

你可以在 Obsidian 内部启动一个 ObsidianURI. 因为obsidian://是一个自定义的连接方式，它不会被直接认为是一个链接。我们可以通过将他涵盖在一个 markdown 链接里来修复这一点。

[This here is shown](obsidian://advanced-uri?filepath=Home%20Index%2Ftoday)

终端

Linux

对于xdg-open来说整个 URI 编码需要编译两次.查看编码来获得更多信息

xdg-open "obsidian://advanced-uri?filepath=Home%2520Index%252Ftoday"

Mac

你可以使用 Mac 的 shell 命令open来启动 Obsidian，并使用--background参数来让 Obsidian 在后台运行。

open --background "obsidian://advanced-uri?vault=my-vault&filename=my-file&data=my-data"