Title As Link Text

Transform your Obsidian links from plain filenames into meaningful titles automatically! 🔄

✨ What It Does

Title As Link Text is an Obsidian plugin that intelligently transforms your links to use note titles instead of filenames. Whether you're using Markdown-style links or Wikilinks.

Before:

[[20230408102501]]
[document-name](./complex-topic.md)

After:

[[20230408102501|My Awesome Note]]
[Understanding Complex Topics](./complex-topic.md)

⚡ Key Features

• Smart Title Detection: Automatically finds the best title from frontmatter, H1 headers, or filenames
• Multiple Link Styles:
  • Wikilinks: [[file-name|Note Title]]
  • Markdown: [Note Title](./file-name.md)
• Alias Support: Respects your custom aliases with smart matching
• Automatic Updates: Links update automatically when you save or rename files

🎯 Perfect For

• Zettelkasten enthusiasts using timestamp-based filenames
• Writers who want readable titles with special characters (?, ,, etc.)
• Anyone seeking a cleaner, more professional-looking vault

⚠️ WARNING

This plugin can modify multiple files when notes with backlinks are changed. Please backup your vault before using.

🚀 Installation

Via BRAT (Recommended for Beta Access)

1. Install BRAT
2. Navigate to Settings → Community Plugins → Obsidian42 - BRAT
3. Click "Add Beta plugin"
4. Enter: lextoumbourou/obsidian-title-as-link-text
5. Enable "Title As Link Text" under Community Plugins

🔧 How It Works

Title Inference Logic

1. Frontmatter First: Checks for title in frontmatter

   ---
   title: My Note
   ---

2. H1 Headers: Falls back to first # heading

   # My Note

3. Filename Fallback: Uses filename if no other title is found

Smart Alias Matching

• Substring Detection: Matches partial aliases (e.g., "Project" → "My Project Name")
• Fuzzy Matching: Finds close matches when no exact match exists
• Preserves Intentional Variations: Respects your custom aliases

🤝 Recommended Companion Plugins

For Markdown-style users:

• Wikilinks To Markdown: Convert existing Wikilinks
• Front Matter Title: Consistent title display

🛠️ Commands

• Update All Links: One-click update for all existing links in your vault

👩‍💻 Development

nvm use 16
npm install
npm run build

📄 License

MIT

---

Made with ❤️ for the Obsidian community