Skip to content
创建日期: 2026-06-11 22:32:18
最后更新: 2026-06-11 22:32:18
修订次数: 1

VitePress中使用

安装

sh
npm i -D @mdit/plugin-img-size
sh
pnpm add -D @mdit/plugin-img-size
sh
yarn add -D @mdit/plugin-img-size

导入

.vitepress/config.mts

ts
import MarkdownIt from "markdown-it";
import { legacyImgSize, imgSize, obsidianImgSize } from "@mdit/plugin-img-size";

// 新格式
const mdNew = MarkdownIt().use(imgSize);
mdNew.render("![image =300x200](https://example.com/image.png =300x200)");

// Obsidian 格式
const mdObsidian = MarkdownIt().use(obsidianImgSize);
mdObsidian.render("![image|300x200](https://example.com/image.png)");

// 旧格式
const mdLegacy = MarkdownIt().use(legacyImgSize);
mdLegacy.render("![image](https://example.com/image.png =300x200)");

.vitepress/config.mts

ts
export default defineConfig({
    markdown: {
        config(md) {
            md.use(imgSize);
        }
    }
})

语法

新语法

在图片替代文字后面添加 =widthxheight,并用空格分隔。

widthheight 都应该是数字,单位为像素,并且都是可选的。

md
![替代文字 =200x300](/example.png)
![替代文字 =200x](/example.jpg "标题")
![替代文字 =x300](/example.bmp)

渲染为 ↓

html
<img src="/example.png" alt="替代文字" width="200" height="300" />
<img src="/example.jpg" alt="替代文字" title="标题" width="200" />
<img src="/example.bmp" alt="替代文字" height="300" />

Released under the MIT License.