# Image Markdown Link

[English](#english) | [中文](#中文)

---

## English

Convert pasted images from Obsidian's wiki-link format to standard Markdown image syntax automatically.

When you paste an image into Obsidian, it normally inserts `![[filename.png]]` (wiki-link) or `[](filename.png)` (bare Markdown link) depending on your vault settings. This plugin intercepts that and rewrites the link to `![](filename.png)` — the standard Markdown image syntax compatible with any Markdown renderer outside Obsidian.

### Features

- Works with all link formats Obsidian may auto-generate:

  | Auto-generated by Obsidian | Converted to |
  |---|---|
  | `![[filename.png]]` | `![](filename.png)` |
  | `![[subfolder/filename.png]]` | `![](subfolder/filename.png)` |
  | `[[path/filename.png]]` | `![](path/filename.png)` |
  | `[](path/filename.png)` | `![](path/filename.png)` |
  | `![](path/filename.png)` | (already correct — no change) |

- Handles attachment folders at any depth (root, subfolder, relative paths)
- Supports image formats: `png`, `jpg`, `jpeg`, `gif`, `webp`, `bmp`, `svg`, `avif`
- Non-image wiki links (e.g. `[[note.md]]`) are never modified

### Installation

**From the Community Plugin Browser (recommended)**

1. Open **Settings** → **Community plugins** and disable Safe mode if prompted
2. Click **Browse**, search for **Image Markdown Link**, and install it
3. Enable the plugin under **Installed plugins**

**Manual Installation**

1. Download `main.js` and `manifest.json` from the [latest release](../../releases/latest)
2. Create the folder `<your-vault>/.obsidian/plugins/image-markdown-link/` and place both files inside
3. Open **Settings** → **Community plugins**, find **Image Markdown Link**, and enable it

### Usage

No configuration needed. After enabling the plugin:
** IF it's not working, then DISABLE the plugin first, and re-enable the plugin again, it should work now. ** 
1. Open any Markdown note
2. Paste an image from the clipboard
3. Obsidian saves the image file and inserts a link — the plugin automatically rewrites it to `![](path/to/image.png)`

> **Note:** If your vault is already set to use Markdown links globally (**Settings → Files and links → Use [[Wikilinks]]** is OFF), Obsidian generates `![](...)` directly and the plugin skips conversion.

### Compatibility

- Minimum Obsidian version: **1.5.7**
- Platforms: desktop and mobile

---

## 中文

自动将 Obsidian 粘贴图片时生成的 Wiki 链接格式转换为标准 Markdown 图片语法。

在 Obsidian 中粘贴图片时，程序通常会根据 Vault 设置插入 `![[filename.png]]`（Wiki 链接）或 `[](filename.png)`（纯 Markdown 链接）。本插件会自动将其改写为 `![](filename.png)`——即标准 Markdown 图片语法，可在 Obsidian 以外的任何 Markdown 渲染器中正常显示。

### 功能特性

- 支持 Obsidian 可能自动生成的所有链接格式：

  | Obsidian 自动生成 | 转换结果 |
  |---|---|
  | `![[filename.png]]` | `![](filename.png)` |
  | `![[subfolder/filename.png]]` | `![](subfolder/filename.png)` |
  | `[[path/filename.png]]` | `![](path/filename.png)` |
  | `[](path/filename.png)` | `![](path/filename.png)` |
  | `![](path/filename.png)` | （已是正确格式，不做处理）|

- 兼容任意深度的附件文件夹（根目录、子目录、相对路径）
- 支持图片格式：`png`、`jpg`、`jpeg`、`gif`、`webp`、`bmp`、`svg`、`avif`
- 非图片 Wiki 链接（如 `[[note.md]]`）不会被修改

### 安装方式

**通过社区插件市场安装（推荐）**

1. 打开 **设置** → **第三方插件**，如提示请关闭安全模式
2. 点击 **浏览**，搜索 **Image Markdown Link** 并安装
3. 在已安装插件列表中启用该插件

**手动安装**

1. 从 [最新 Release](../../releases/latest) 下载 `main.js` 和 `manifest.json`
2. 在 Vault 中创建文件夹 `<你的Vault>/.obsidian/plugins/image-markdown-link/`，将两个文件放入其中
3. 打开 **设置** → **第三方插件**，找到 **Image Markdown Link** 并启用

### 使用方法

无需任何配置，启用插件后：
** 如果发现安装后插件不工作，那么先重新禁用插件，然后再重新打开插件一次，就可以了**
1. 打开任意 Markdown 笔记
2. 从剪贴板粘贴图片
3. Obsidian 保存图片文件并插入链接——插件自动将其改写为 `![](path/to/image.png)`

> **注意：** 若 Vault 已全局设置使用 Markdown 链接（**设置 → 文件与链接 → 使用 [[Wiki链接]]** 已关闭），Obsidian 会直接生成 `![](...)` 格式，插件将跳过转换。

### 兼容性

- 最低 Obsidian 版本：**1.5.7**
- 平台：桌面端与移动端均支持