Obsidian 插件：Alias from heading

概述

隐式添加一个与文档中第一个标题匹配的别名。

Readme(翻译）

下面是 obsidian-alias-from-heading 插件的自述翻译

标题别名

在 Obsidian 中，别名可以方便地为文档链接提供显示名称。然而，存在一些问题：

• 别名是在YAML中管理的，可能使用起来不太方便。
• 链接的显示名称不会随着别名的更改而同步更新。

该插件通过以下方式解决了这些问题：

• 隐式地为文档添加一个别名，该别名与该文档中的第一个标题匹配，无论标题级别如何。
• 当 输入[[添加链接 时，该别名将作为建议显示。
• 如果在同一文档中存在重复的别名（来自 YAML 或标题），在输入 [[ 或使用快速切换器时，不会出现重复的链接建议。
• 更新文档中的第一个标题只会更新与该标题匹配的链接的显示名称。这样可以根据特定的上下文自定义链接的显示名称，但默认情况下，链接的显示名称将与标题保持同步。
• 在 YAML 中定义的任何别名仍然按照它们的标准方式工作，并且不会影响该插件的行为。与标题别名不同，更新 YAML 中的别名不会更新其关联链接的显示名称。

<!-- 2022-06-08-1030.md -->

---
aliases: "🍅 建造一个花园"
---

🍅 建造一个花园

• 检查院子
• 选择一个设计
• 购买材料
• 建造框架
• 准备地面
• 填充花床

使用这个插件，别名的前置内容不再需要。

```md
<!-- 2022-06-08-1030.md -->

# 🍅 建造一个花园

- 观察院子
- 选择一个设计
- 购买材料
- 建造框架
- 准备地面
- 填充花床

这个第二个文档只通过文件名链接到第一个文档。

<!-- 2022-02-02-1445.md -->

# 🥬 园艺项目

- [[2022-06-08-1030]]
- 发芽种子
- ...

然而，通常更易读的做法是使用友好的显示名称链接到文档。键入 [[，按照标题搜索文档，并选择插入。

<!-- 2022-02-02-1445.md -->

🥬 园艺项目

• 🍅 建造一个花园
• 发芽种子
• …

现在，显示名称与它链接到的第一个文档的第一个标题匹配，它们保持同步。将第一个文档中的标题从 🍅 建造一个花园 更新为 🥕 建造一个提升的花园床。现在第二个文档显示了变化。

<!-- 2022-02-02-1445.md -->

# 🥬 园艺项目

- [[2022-06-08-1030|🥕 建造一个提升式花园床]]
- 发芽种子
- ...

如果从第一个文档中删除了所有标题，那么任何保持同步的链接都会被更新，以使其显示名称与文件名匹配。这种行为使得稍后插入新标题时保持链接显示名称同步变得容易。同时，它也使得链接的预览仍然有意义。

<!-- 2022-02-02-1445.md -->

🥬 园艺项目

• 2022-06-08-1030
• 发芽种子
• …

如果想要自定义显示名称或者不显示名称，只需手动内联更改。除非手动改回与标题匹配，否则它不会与标题保持同步。

```md
<!-- 2022-02-02-1445.md -->

# 🥬 园艺项目

- [[2022-06-08-1030|🌽 花坛]]
- 发芽种子
- ...

开发者指南

阅读[Obsidian示例插件](https://github.com/obsidianmd/obsidian-sample-plugin)的自述文件和[Obsidian插件开发者文档](https://marcus.se.net/obsidian-plugin-docs/)，了解如何开发、安装、测试和发布此插件。