You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-📋 Paste images directly from your system clipboard
12
-
-🖱️ Seamlessly drag and drop images from your web browser or file explorer
13
-
-📁 Embed images as files, web URLs, or Base64-encoded data
14
-
-🌐 Automatically download and embed images from the web
15
-
-⚙️ Process images using configurable shell commands
16
-
-🎨 Configurable templates with placeholders for file paths, labels, and cursor positioning
17
-
-📝 Built-in templates for popular markup languages like LaTeX, Markdown, and Typst
18
-
-🔧 Extensive configuration options, including per-project, per-directory, and per-filetype settings
19
-
-🔌 Powerful API with example integrations for popular plugins like [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim) and [oil.nvim](https://github.com/stevearc/oil.nvim)
20
-
-💻 Compatible with Linux, macOS, and Windows, including WSL!
15
+
- Paste images directly from your system clipboard
16
+
- Seamlessly drag and drop images from your web browser or file explorer
17
+
- Embed images as files, web URLs, or Base64-encoded data
18
+
- Automatically download and embed images from the web
19
+
- Process images using configurable shell commands
20
+
- Configurable templates with placeholders for file paths, labels, and cursor positioning
21
+
- Built-in templates for popular markup languages like LaTeX, Markdown, and Typst
22
+
- Extensive configuration options, including per-project, per-directory, and per-filetype settings
23
+
- Powerful API with example integrations for popular plugins like [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim) and [oil.nvim](https://github.com/stevearc/oil.nvim)
24
+
- Compatible with Linux, macOS, and Windows, including WSL!
@@ -195,7 +199,8 @@ The plugin is highly configurable. Please refer to the default configuration bel
195
199
196
200
Option values can be configured as either static values (e.g. "assets"), or by dynamically generating them through functions.
197
201
198
-
<details> <summary>Example: Dynamically set the dir path</summary>
202
+
<details>
203
+
<summary>Example: Dynamically set the dir path</summary>
199
204
200
205
To set the `dir_path` to match the name of the currently opened file:
201
206
@@ -204,14 +209,14 @@ dir_path = function()
204
209
returnvim.fn.expand("%:t:r")
205
210
end,
206
211
```
207
-
208
212
</details>
209
213
210
214
### Processing images
211
215
212
216
The `process_cmd` option allows you to specify a shell command to process the image before saving or embedding it as base64. The command should read the image data from the standard input and write the processed data to the standard output.
213
217
214
-
<details> <summary>Example: ImageMagick</summary>
218
+
<details>
219
+
<summary>Example: ImageMagick</summary>
215
220
216
221
```bash
217
222
process_cmd = "convert - -quality 85 -" -- compress the image with 85% quality
@@ -220,7 +225,6 @@ process_cmd = "convert - -colorspace Gray -" -- convert the image to grayscale
220
225
```
221
226
222
227
Ensure the specified command and its dependencies are installed and accessible in your system's shell environment. The above examples require [ImageMagick](https://imagemagick.org/index.php) to be installed.
The drag and drop feature enables users to drag images from the web browser or file explorer into the terminal to automatically embed them, in normal mode.
387
391
Drag and drop can also be enabled in insert mode by setting the `drag_and_drop.insert_mode` option to `true`.
@@ -566,13 +570,14 @@ A list of terminal emulators and their capabilities is given below.
566
570
> [!WARNING]
567
571
> MacOS URLs only work in Safari.
568
572
569
-
## 🔌 Integrations
573
+
## Integrations
570
574
571
575
### Telescope.nvim
572
576
573
577
The plugin can be integrated with [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim) to provide a seamless way to select and embed images using Telescope's powerful fuzzy finding capabilities.
The above function should be bound to a keymap, e.g. through lazy.nvim.
604
-
605
609
</details>
606
610
607
611
### Oil.nvim
608
612
609
613
The plugin also integrates with [oil.nvim](https://github.com/stevearc/oil.nvim), providing a convenient way to browse and select images using Oil's file explorer.
0 commit comments