Heading Linker

unlisted

by zm

Automatically update heading links when a heading is modified.

Updated 2mo ago
View on GitHub

HeadingLinker 插件

HeadingLinker 是一个 Obsidian 插件，在用户修改笔记的标题时自动更新文档中相关的内部链接，提升笔记维护的效率和准确性。

功能特点

  • 自动检测标题变更：监听 Obsidian 中的标题重命名事件
  • 智能链接更新：自动识别并更新受影响的内部链接
  • 跨文件支持：能够更新其他文件中指向被重命名标题的链接
  • 实时响应：标题重命名后立即更新相关链接
  • 性能优化：针对大文件进行性能优化，避免不必要的处理
  • 精确统计：更新完成后通知用户更新了多少个链接及涉及的文件数

支持的链接格式

插件支持以下两种常见的内部链接格式：

  1. 维基风格链接：

    • [[Page#Heading]] 或 [[Page#Heading|Alias]]
    • [[#Heading]]（同文件内链接）

  2. Markdown 风格链接：

    • [Text](Page.md#Heading)
    • (#Heading)（同文件内链接）

设置选项

设置界面

防抖间隔 (Debounce interval)

  • 控制插件等待多长时间（毫秒）后开始更新链接
  • 默认值：1000 毫秒
  • 增加此值可以减少频繁更新，适合大型库

同步别名 (Sync alias)

  • 如果启用，当更新链接时，如果别名与旧标题文本匹配，也会更新别名
  • 默认值：关闭

使用方法

  1. 安装插件并启用
  2. 在 Obsidian 设置中配置插件参数（可选）
  3. 正常编辑笔记，重命名标题时插件会自动更新相关链接
  4. 更新完成后会显示通知，告知更新了多少个链接

注意事项

  • 插件只操作用户本地笔记文件，不涉及网络请求或敏感数据
  • 依赖 Obsidian 的内部 API，可能存在版本兼容性风险
  • 对于超大文件，由于性能优化措施，处理速度会更快

版权信息

Copyright © 2025 zm.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.