# Fluent Block Link

**Fluent Block Link** is a lightweight, lightning-fast Obsidian plugin that allows you to instantly generate and copy clickable block reference links for any selected text or current line to your clipboard.

Paste the generated link anywhere across your vault — in other notes, canvas, tables, or task lists — and click to jump directly to the exact sentence or paragraph.

---

## ✨ Features

- **Selection or Line**:
  - **With selection**: Copies `[[Note#^blockid|Selected text]]` using your selection as the link alias.
  - **Without selection**: Automatically targets the current line, copying `[[Note#^blockid|Line text]]`.
- **Intelligent Block ID Handling**: Reuses existing block references if present, or creates a new unique 6-character alphanumeric block ID.
- **Cross-Note Link Resolution**: Links are generated with full vault resolution so they work seamlessly when pasted into any other note.
- **Clean Formatting**: Automatically strips markdown prefixes (headers `# `, list bullets `- [ ] `, `* `, `1. `, blockquotes `> `) from the alias text for clean, elegant inline links.
- **Multiple Link Formats**:
  - **With Alias** (Default): `[[Note#^blockid|Alias]]`
  - **Raw Link**: `[[Note#^blockid]]`
  - **Embed Block**: `![[Note#^blockid]]`

---

## 🚀 How to Use

1. Open any note in Obsidian.
2. Select any text (or just place your cursor anywhere on a line).
3. Trigger the command **`Fluent Block Link: Copy block reference link`** (or press your custom hotkey).
4. Paste (`Ctrl + V` / `Cmd + V`) anywhere in your vault.
5. Click the link to jump directly to the referenced sentence or block!

---

## ⌨️ Available Commands

| Command | Description | Example Output |
|---|---|---|
| **`Copy block reference link`** | Copies link using your default format setting (default: with alias) | `[[My Note#^abc123\|Selected sentence]]` |
| **`Copy raw block link (without alias)`** | Copies raw wikilink | `[[My Note#^abc123]]` |
| **`Copy block embed link`** | Copies block embed | `![[My Note#^abc123]]` |

*Tip: Go to **Settings → Hotkeys** and search for `Fluent Block Link` to bind a hotkey (e.g. `Alt + C` or `Ctrl + Shift + C`).*

---

## ⚙️ Settings

- **Default link format**: Switch between *With alias*, *Raw link*, and *Embed block*.
- **Clean alias formatting**: Toggle whether markdown headers, bullets, and blockquotes should be stripped from the alias text.
- **Show copy notice**: Toggle notification popups when links are copied.

---

## 📦 Installation

### From Obsidian Community Plugins
1. Open **Settings → Community plugins**.
2. Turn off **Restricted mode**.
3. Click **Browse** and search for **`Fluent Block Link`**.
4. Click **Install**, then **Enable**.

---

## 📄 License

MIT License © 2026 [Jeff1024](https://github.com/2607044640)