Xz's blog Xz's blog
首页
时间序列
多模态
合成生物学
其他方向
生活
工具相关
PyTorch
导航站

Xu Zhen

首页
时间序列
多模态
合成生物学
其他方向
生活
工具相关
PyTorch
导航站
  • 博客相关

    • VuePress 部署服务器
    • GitHub Action 自动化部署网站
    • 使 VuePress 支持图片中包含中文字符
      • 具体问题原因:
      • 解决办法
      • 参考文章
    • 使 VuePress 支持公式
    • Vdoing-VuePress 支持 webp 格式图片
  • 生活
  • 博客相关
xuzhen
2025-07-03
目录

使 VuePress 支持图片中包含中文字符

一直使用 Obsidian 来写 markdown,但是使用 Obsidian 和 VuePress 在静态图片资源路径管理上有一些冲突,我使用 Obsidian 的相对路径来存储图像, Obsidian 与 VuePress 之间存在以下冲突:

  • 当 VuePress1.x 处理带有中文和空格的图片路径时存在问题,VuePress 会找不到资源路径 。
  • VuePress 要求图片格式需以 ./ 或者 ../ 开头,Obsidian 不要容易做到,需要自己写一个插件

# 具体问题原因:

假如有 Obsidian 的图像路径:

![image](./图片/image.png)
1

VuePress的处理方式:

%E5%9B%BE%E7%89%87/image.png
1

中文的资源路径被转译了 ./图片/image.png ===> ./%E5%9B%BE%E7%89%87/image.png 并且 webpack 并没有找到 %E5%9B%BE%E7%89%87/image.png 此资源

# 解决办法

  1. 安装 markdown-it-disable-url-encode
npm i markdown-it-disable-url-encode
1
  1. 将其注入vuepress 配置文件中 .vuepress/config.js
    module.exports = {
      // .....
      markdown: {
        // ......
        extendMarkdown: md => {
          md.use(require("markdown-it-disable-url-encode"));
        }
      }
    };
1
2
3
4
5
6
7
8
9

.vuepress/config.ts

import markdownItDisableUrlEncode from "markdown-it-disable-url-encode";
markdown: {
	//......
    extendMarkdown: md => {
      md.use(markdownItDisableUrlEncode);   //解决图片链接中文资源问题
	  //......
    },
  },
1
2
3
4
5
6
7
8

# 参考文章

https://segmentfault.com/a/1190000022275001 (opens new window) https://github.com/nanyuantingfeng/markdown-it-disable-url-encode (opens new window)

#VuePress
上次更新: 2025/07/05, 22:15:22

← GitHub Action 自动化部署网站 使 VuePress 支持公式→

最近更新
01
Slice切片
07-26
02
引用与借用
07-26
03
所有权
07-26
更多文章>
Theme by Vdoing | Copyright © 2025-2025 Xu Zhen | 鲁ICP备2025169719号
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式