Image Markdown Link

Image Markdown Link

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 ![](https://raw.githubusercontent.com/ariayd/obsidian-image-markdown-link/HEAD/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]]	
  ![[subfolder/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
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 ![](https://raw.githubusercontent.com/ariayd/obsidian-image-markdown-link/HEAD/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 ![](https://raw.githubusercontent.com/ariayd/obsidian-image-markdown-link/HEAD/...) 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 链接）。本插件会自动将其改写为 ![](https://raw.githubusercontent.com/ariayd/obsidian-image-markdown-link/HEAD/filename.png)——即标准 Markdown 图片语法，可在 Obsidian 以外的任何 Markdown 渲染器中正常显示。

功能特性

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

  Obsidian 自动生成	转换结果
  ![[filename.png]]	
  ![[subfolder/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 下载 main.js 和 manifest.json
2. 在 Vault 中创建文件夹 <你的Vault>/.obsidian/plugins/image-markdown-link/，将两个文件放入其中
3. 打开 设置 → 第三方插件，找到 Image Markdown Link 并启用

使用方法

无需任何配置，启用插件后： ** 如果发现安装后插件不工作，那么先重新禁用插件，然后再重新打开插件一次，就可以了**

1. 打开任意 Markdown 笔记
2. 从剪贴板粘贴图片
3. Obsidian 保存图片文件并插入链接——插件自动将其改写为 ![](https://raw.githubusercontent.com/ariayd/obsidian-image-markdown-link/HEAD/path/to/image.png)

注意： 若 Vault 已全局设置使用 Markdown 链接（设置 → 文件与链接 → 使用 [[Wiki链接]] 已关闭），Obsidian 会直接生成 ![](https://raw.githubusercontent.com/ariayd/obsidian-image-markdown-link/HEAD/...) 格式，插件将跳过转换。

兼容性

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