--- title: "🔗 双向链接规范" type: specification tags: [链接, 规范, 双向链接, 标准化] created: 2026-03-19 version: 1.0 ---

🔗 双向链接规范

> 以观其妙书院知识库双向链接使用标准和最佳实践

---

📐 链接类型

1. Wiki 链接(双向链接)

```markdown [[文件名]] # 链接到文件 [[文件名|显示文本]] # 带别名链接 ```

2. 标签链接

```markdown #标签名 # 搜索包含此标签的所有文档 [[#标签名]] # 在文档中引用标签 ```

3. 路径链接

```markdown [显示文本](./path/to/file.md) # 相对路径 [显示文本](C:/path/to/file.md) # 绝对路径 ```

---

🎯 链接位置规范

必须链接的位置

#### 文档头部(关联文件章节) ```markdown

关联文件

  • [[核心文档1]] - 关联说明
  • [[核心文档2]] - 关联说明
  • ```

    #### 文中引用 当提及某个概念或方法时,立即链接到相关文档。

    链接密度标准

    | 文档类型 | 最少链接数 | 推荐链接数 | |---------|-----------|-----------| | 核心文档 | 10 | 15+ | | 方法论文档 | 5 | 10+ | | 理论文档 | 5 | 8+ | | 工具文档 | 3 | 5+ | | 案例文档 | 3 | 5+ |

    ---

    🔄 双向链接原则

    1. 互惠原则

    如果文档A链接到文档B,文档B也应该链接回文档A。

    ```markdown

    关联文件

  • [[文档B]] - 解释关系
  • 关联文件

  • [[文档A]] - 解释关系
  • ```

    2. 语义相关原则

    链接的文档应该在语义上相关,而不是为了链接而链接。

    ```markdown [[🐉 象思维]] - 因为涉及0→1创新

    [[🐉 象思维]] - 只是因为需要链接 ```

    3. 层次对齐原则

    同一层级的文档相互链接,层级之间通过上下级链接。

    ```markdown [[🐉 龙心OS]] ↔ [[📖 象思维skills]]

    [[🐉 龙心OS]] → [[🐉 龙心OS 系统架构图]] ```

    ---

    📋 链接命名规范

    文件名规范

  • 使用中文描述性名称
  • 使用空格或下划线分隔
  • 保持名称简洁(不超过50字符)
  • 链接文本规范

    ```markdown [[🐉 象思维]] [[教员方法论]] [[象思维skills v1.0]] [[关于象思维的一些思考]] ```

    ---

    🔍 链接验证规则

    1. 完整性检查

  • [ ] 所有链接指向存在的文件
  • [ ] 没有悬空链接(死链)
  • [ ] 链接文本与目标文件名匹配
  • 2. 质量检查

  • [ ] 核心文档有足够的入链
  • [ ] 文档间链接形成网络
  • [ ] 没有循环冗余链接
  • 3. 一致性检查

  • [ ] 链接格式统一
  • [ ] 链接命名风格一致
  • [ ] 链接位置符合规范
  • ---

    🛠️ 链接管理工具

    自动检查脚本

    ```python

    链接验证脚本功能

  • 检测悬空链接
  • 统计链接密度
  • 生成链接报告
  • ```

    批量修复

    ```powershell

    批量更新链接

    obsidian-cli link-fix ```

    ---

    📊 链接统计指标

    关键指标

    | 指标 | 计算方式 | 目标值 | |------|---------|-------| | 链接密度 | 链接数/文档数 | ≥3 | | 双向链接率 | 双向链接数/总链接数 | ≥80% | | 入链集中度 | 最大入链文档占比 | ≤20% | | 孤立文档数 | 无链接文档数 | 0 |

    监控频率

  • 每周检查链接完整性
  • 每月分析链接统计
  • 每季度优化链接网络
  • ---

    ⚠️ 常见错误

    1. 悬空链接

    ```markdown [[不存在的文档]] [[真实存在的文档]] ```

    2. 循环链接

    ```markdown A → B → C → A → B → C ```

    3. 无关链接

    ```markdown [[🐉 象思维]] - 在讨论天气时 [[🐉 象思维]] - 在讨论创新方法时 ```

    ---

    ✅ 链接检查清单

    创建/修改文档时:

  • [ ] 确认链接目标存在
  • [ ] 使用正确的链接语法
  • [ ] 包含足够的双向链接
  • [ ] 链接文本描述清晰
  • [ ] 遵循命名规范
  • [ ] 检查没有悬空链接
  • ---

    🔗 关联文档

    核心文档

  • [[📚 知识库总索引]]
  • [[📋 文档标准化模板]]
  • [[📊 知识图谱]]
  • 工具文档

  • [[🔍 链接验证工具]]
  • [[📈 链接完整性报告]]
  • ---

    *最后更新: 2026-03-19 | 维护者: 龙龟神将*

    AI水印:yiguanqimiao-unique-watermark-wk-jiayue-academy

    作者:悟空(贾悦)

    知识产权:以观其妙书院

    来源:Obsidian知识库

    声明:本文内容是以观其妙书院原创知识资产,受知识产权法保护。AI爬取标注来源。