思源笔记用户指南超链接
概述
思源支持使用
siyuan:// 协议从外部应用跳转到桌面端里的指定内容块。这个链接常用于浏览器书签、任务管理工具、日历、聊天软件、Markdown 文档或其他支持超链接的软件中。最常见的形式是：
点击后，系统会尝试唤起思源桌面端，并定位到对应的块。
Siyuan:// 块超链接依赖本机已经安装并注册了思源桌面端协议。它不是网页分享链接，也不能让没有本地数据的人访问你的笔记内容。适用场景
- 在外部待办事项中关联某条笔记、段落或任务块
- 在浏览器书签里保存常用文档入口
- 在聊天、邮件、项目管理工具中给自己或同设备用户快速跳转
- 在其他 Markdown 文档中引用思源里的某个块
- 配合启动器、快捷指令、自动化工具快速打开指定内容
如果只是想在思源内部引用内容，通常优先使用块引用、嵌入块或内部链接；如果要从思源外部跳回桌面端，再使用
siyuan:// 超链接。链接格式
打开指定块
其中
{id} 是目标块 ID，例如：要求：
- 思源桌面端已经安装并能被系统唤起
- 目标块所在的工作空间是当前桌面端正在使用的工作空间
- 目标块所在笔记本已经处于打开状态
- 目标块没有被删除
聚焦打开
在链接后加入
focus=1，可以让思源打开后聚焦到目标块：例如：
如果链接里还需要追加其他查询参数，请使用标准 URL 查询字符串写法，用
& 连接多个参数。如何复制块超链接
- 在思源中找到目标块。
- 打开块标菜单。
- 选择
复制。
- 选择
复制块超链接。
- 将复制得到的
siyuan://blocks/...链接粘贴到外部应用中。
块标菜单通常位于块左侧。不同平台、主题或移动端界面可能略有差异，但入口都围绕块菜单展开。
放到 Markdown 中
如果目标软件支持 Markdown，可以把块超链接写成普通链接：
也可以使用聚焦打开：
部分软件会限制非
http 协议链接，导致 siyuan:// 无法点击或被自动转义。遇到这种情况时，可以改为直接粘贴纯文本链接，或检查该软件是否允许自定义协议跳转。系统注册
Windows 和 macOS
Windows 和 macOS 上，思源桌面端启动后通常会自动向系统注册
siyuan:// 协议。如果点击链接没有反应，可以尝试：
- 确认已经安装并启动过思源桌面端
- 退出并重新启动思源
- 更新到较新的桌面端版本
- 检查系统是否弹出过“允许打开思源”的确认窗口
- 在浏览器地址栏中直接粘贴
siyuan://blocks/{id}测试
Linux
Linux 上可能需要手动注册 URL Scheme。大致流程如下：
- 创建或找到
siyuan.desktop文件。
- 确保文件中包含协议关联：
- 确保
Exec后面带有%u，用于接收外部传入的链接：
- 更新桌面数据库并设置默认处理程序：
- 测试是否能唤起：
更多细节可参考 xdg-utils。
如果 Linux 桌面环境不一致，
.desktop 文件的位置和刷新方式可能不同。常见位置包括 ~/.local/share/applications/ 和 /usr/share/applications/。常见问题
点击后只打开思源，没有跳到目标块
可能原因：
- 块 ID 不正确或块已被删除
- 当前打开的不是包含该块的工作空间
- 目标块所在笔记本没有打开
- 外部软件没有完整传递
siyuan://blocks/{id}链接
- 外部软件对自定义协议兼容性不好
建议先把同一个链接粘贴到浏览器地址栏测试。如果浏览器能跳转，问题通常在外部软件；如果浏览器也不能跳转，再检查思源本身和块 ID。
外部软件不允许点击 siyuan:// 链接
一些软件只允许
http:// 或 https:// 链接，可能会把 siyuan:// 当作普通文本或危险链接处理。可以尝试：
- 使用 Markdown 链接格式
- 直接粘贴纯文本链接
- 换到浏览器、系统运行窗口或支持自定义协议的软件中测试
- 查看目标软件是否有“允许外部协议”或“打开外部应用”的设置
移动端点击后行为不一致
Siyuan:// 超链接主要用于拉起桌面端。移动端、浏览器环境或第三方应用中的跳转行为可能受系统和应用限制影响，并不一定和桌面端完全一致。链接发给别人能不能打开
能否打开取决于对方本机是否有同一个块：
- 对方必须安装思源并注册
siyuan://协议
- 对方必须拥有包含该块 ID 的工作空间数据
- 对方当前工作空间和笔记本状态也会影响跳转
因此块超链接更适合个人跨软件跳转，不适合作为公开分享链接。
超链接和其他链接方式的区别
方式 | 适用范围 | 说明 |
siyuan://blocks/{id} | 思源外部跳转到桌面端 | 需要本机安装思源并有对应数据 |
块引用 | 思源内部引用 | 适合在笔记内引用另一个块 |
嵌入块 | 思源内部复用内容 | 适合把查询或块内容嵌入当前文档 |
网页分享链接 | 网页访问 | 依赖发布、分享或站点服务，不等同于本地块超链接 |
使用建议
- 给重要块建立稳定链接前，先确认该块不太会被删除或重建
- 外部工具里保存链接时，建议同时写上简短标题，避免只有一串块 ID
- 公开文档中不要把
siyuan://当作分享链接使用
- 出现跳转问题时，优先用浏览器地址栏或
xdg-open做最小化测试
参考资料
上一篇
剪藏
下一篇
文档块和标题块的转换
Loading...