必须区分vscode原生粘贴与paste image插件：前者用markdown.copyfiles.destination配置路径，仅支持${documentbasename}等四个变量；后者用pasteimage.path和pasteimage.nameformat，支持${currentyear}、${random}等更多变量，且两者变量不互通、路径逻辑独立。
能，但必须分清是用 VSCode 原生功能，还是用 Paste Image 插件——两者配置位置、变量名、行为逻辑完全不同，混用会导致粘贴失效或路径错乱。
VSCode 原生粘贴图片：靠 markdown.copyFiles.destination 配置路径
VSCode 1.80+ 内置该能力，无需插件。它只响应 Ctrl+V（或 Cmd+V），且仅对 Markdown 文件生效。
- 打开设置（
Ctrl+,），搜索markdown.copyFiles.destination - 点击「Add Item」，Key 填
**/*.md，Value 填类似assets/${documentBaseName}/${documentBaseName}_${unixTime}.${fileExtName}的相对路径 - 关键变量只有四个：
${documentBaseName}（当前 .md 文件名，不含扩展）、${unixTime}（毫秒级时间戳，防重名）、${fileExtName}（.png/.jpg 等）、${documentDirName}（文件所在目录名，慎用，含斜杠可能出错） - 不支持
${random}、${currentYear}等变量——那些是 Paste Image 插件的语法，VSCode 原生不认 - 如果粘贴没反应，先检查设置里
markdown.experimental.copyFiles.enabled是否为true（默认开启，但某些工作区可能被覆盖）
Paste Image 插件粘贴：用 pasteImage.path 和 pasteImage.nameFormat
这是更灵活的方案，支持自定义快捷键（默认 Ctrl+Alt+V）、更多命名变量、压缩、图床上传等扩展能力。
Telegram Markdown Adapter
下载
将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。
- 安装插件后，在设置中搜索
pasteImage.path，填入如${projectRoot}/assets/images或./assets/images -
pasteImage.nameFormat支持${random}、${currentYear}、${currentMonth}、${currentDate}等，例如：img-${currentYear}${currentMonth}${currentDate}-${random} - 注意：
${projectRoot}指工作区根目录；./是相对于当前打开的 Markdown 文件所在目录，不是项目根目录 - 若图片插入后链接是绝对路径（如
/Users/xxx/.../img.png），大概率是pasteImage.path写成了绝对路径，或漏配pasteImage.forceRelativePath（设为true可强制生成相对链接） - 该插件不依赖
markdown.copyFiles.destination，两个配置共存时互不影响，但别指望它们共享变量或路径逻辑
为什么图片粘贴后链接显示正常但预览/导出不显示？
根本原因几乎总是路径解析失败，而非图片没存进去。
- 检查插入的 Markdown 链接是否以
./或../开头：如果只是，说明 VSCode 原生粘贴没生效（可能匹配不到**/*.md规则），或 Paste Image 插件的forceRelativePath关闭了 - 确认图片实际保存位置与链接路径是否匹配：比如链接是
，就去当前 .md 文件所在目录下找assets/images/xxx.png，而不是项目根目录 - VSCode 预览器只识别相对于当前文档的路径，不支持
~/或环境变量；导出工具（如 md2pdf、Typora）也大多遵循同一规则 - 跨平台协作时，Windows 路径分隔符
\可能被误写进链接，务必确保所有路径使用正斜杠/
最易被忽略的一点：VSCode 原生粘贴和 Paste Image 插件的变量系统完全隔离，${unixTime} 和 ${currentTimestamp} 不通用，${projectRoot} 在原生配置里根本不存在。选哪套方案不重要，关键是别把两套语法混在同一个配置项里——那只会让图片消失得无声无息。
