# AutoLink [![GitHub contributors from allcontributors.org](https://img.shields.io/github/all-contributors/NellowTCS/Obsidian-AutoLink)](#contributors) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/NellowTCS/Obsidian-AutoLink/release.yml) ![GitHub License](https://img.shields.io/github/license/NellowTCS/Obsidian-Autolink) Automatically creates backlinks between your notes with intelligent word completion and customizable behavior. Available on [Obsidian](https://community.obsidian.md/plugins/autolink)! ## Features - **Smart word completion**: Creates backlinks when you finish typing note titles - **Multiple modes**: Choose from autonomous, semi-autonomous, suggestions, or custom modes - **Easy undo**: Press backspace, delete, or Ctrl+Shift+Z to undo any auto-link - **Alias support**: Matches note aliases from frontmatter - **Conflict resolution**: Waits for disambiguation when multiple notes have similar names ## Modes ### Autonomous Keeps a list of all your notes and automatically inserts backlinks when you complete typing a word that matches a note title. **Example:** - Notes: `Note`, `Note1`, `Note with Space` - Writing in any note: `Note1 has etc` - Becomes: `[[Note1]] has etc` **Smart disambiguation:** If multiple notes share prefixes, the plugin waits until you complete the word to determine the correct match. **Example:** - Notes: `Note`, `Note with Space` - Writing: `Note ` (space typed) - Since both `Note` and `Note with Space` start with "Note", it waits - After: `Note has etc` - Becomes: `[[Note]] has etc` ### Semi-Autonomous Works exactly like Autonomous mode, but only creates backlinks to notes in the current folder. - Root directory: only links to other root notes - Subfolder: only links to notes in the same subfolder ### Suggestions Shows a popup below your cursor with matching notes instead of auto-inserting. - Press Enter/Return to accept a suggestion - Press Escape to dismiss - Navigate with arrow keys ### Custom Provides full customization over when and how backlinks are created. **Options:** - Choose specific folders to scan - Toggle Enter key acceptance for suggestions - Enable/disable auto-insertion for single matches - Fine-tune behavior to match your workflow ## Settings - **Mode**: Choose your preferred linking behavior - **Minimum word length**: Set the minimum characters before linking activates (1-10) - **Case sensitive matching**: Toggle case sensitivity for note matching - **Include aliases**: Match against frontmatter aliases in addition to note titles - **Debounce delay**: Adjust typing delay before processing (50-1000ms) - **Max suggestions**: Limit popup suggestions (1-20) ## Undo Options - **Backspace/Delete**: Immediate undo when pressed right after a link is created - **Ctrl+Shift+Z**: Undo the last auto-link from anywhere - Both methods temporarily disable auto-linking to prevent conflicts ## Installation ### Direct (Recommended) You can install **Autolink** directly from Obsidian’s Community Plugins browser (or online [here](https://community.obsidian.md/plugins/autolink)). 1. Open **Settings -> Community Plugins** 2. Make sure **Restricted Mode** is off 3. Click **Browse** 4. Search for **“Autolink”** 5. Click **Install**, then **Enable** ### Manual If you prefer installing manually: 1. Download the latest release from the repo’s **Releases** page - You need: - `main.js` - `manifest.json` - `styles.css` (if present) 2. Create a folder in your vault: ``` .obsidian/plugins/autolink ``` 3. Place all downloaded files inside that folder 4. Restart Obsidian 5. Go to **Settings -> Community Plugins** and enable **Autolink** ### Install ## Technical Details - Built with TypeScript - Debounced input processing for performance - Intelligent cursor positioning and conflict detection ## Star History Star History Chart ## Contributors
Moy
Moy

🐛
JoonasBjork
JoonasBjork

🐛
GrimbiXcode
GrimbiXcode

💻 ⚠️