Title As Link Text: automatic note titles in Obsidian links
I've built Title As Link Text, a new Obsidian plugin that automatically updates your links to use the note's title instead of the filename.
If you use a Zettelkasten-style system or just have notes with slugged filenames, you end up with links that look like this:
[[20230408102501]]
[document-name](./complex-topic.md)
When what you actually want is:
[[20230408102501|My Awesome Note]]
[Understanding Complex Topics](./complex-topic.md)
The plugin handles both Wikilinks and Markdown links, and updates them automatically whenever you save or rename a file. It plays nicely with other plugins that make Obsidian play nice with Markdown links, like Frontmatter Title and Wikilinks to MDLinks.
How it finds the title
It checks three things in order:
- A frontmatter property (default:
title) - The first H1 heading in the file
- The filename itself as a fallback
So if you have a title in your frontmatter, that wins. If not, it looks for a # Heading. If neither exists, it just uses the filename as-is.
You can also configure which frontmatter property to use, so if you prefer name, heading, or something custom, that works too.
Alias support
It also handles aliases. If a note has aliases defined in frontmatter and a link text matches one of them (even partially or fuzzily), the plugin leaves it alone rather than overwriting it with the title. You can tune the similarity threshold or turn alias matching off entirely if you don't want it.
Installation
It's available as a Community Plugin.
- Open Settings > Community Plugins > Browse
- Search for Title As Link Text
- Click Install
There are also two commands available if you want to do a one-off update rather than relying on auto-save: "Update all links" and "Update links for current file".
See the project GitHub for more details.