使用VSCode API的markdown.showPreview打开HTTP URI预览失败求助

问题原因 #

VS Code的markdown.showPreview命令默认仅支持本地file://协议的URI，无法直接识别并加载远程HTTP/HTTPS资源——它依赖VS Code的文档系统读取内容，而远程资源不在本地工作区范围内，直接传远程URI会因无法解析内容而失效。

解决方案步骤 #

要实现远程Markdown预览，需要先获取远程内容，再通过临时文档承载内容后调用预览命令：

• 获取远程Markdown文本内容
• 创建未保存的临时Markdown文档
• 针对临时文档执行预览命令

完整代码示例 #

const vscode = require('vscode');
const https = require('https');

async function showRemoteMarkdownPreview(url) {
    // 1. 拉取远程Markdown内容
    const markdownContent = await new Promise((resolve, reject) => {
        https.get(url, (res) => {
            let data = '';
            res.on('data', (chunk) => {
                data += chunk;
            });
            res.on('end', () => {
                resolve(data);
            });
        }).on('error', (err) => {
            reject(err);
        });
    });

    // 2. 创建临时虚拟Markdown文档
    const tempDoc = await vscode.workspace.openTextDocument({
        content: markdownContent,
        language: 'markdown'
    });

    // 3. 打开预览
    await vscode.commands.executeCommand('markdown.showPreview', tempDoc.uri);
}

// 调用示例
showRemoteMarkdownPreview('https://raw.githubusercontent.com/wiki/fortran-lang/vscode-fortran-support/v3.3.0.md')
    .catch(err => vscode.window.showErrorMessage(`加载预览失败: ${err.message}`));

注意事项 #

• 若使用第三方HTTP库（如axios），需在扩展的package.json中声明依赖，并确保打包时包含该库
• 临时文档不会保存到本地磁盘，关闭VS Code后自动消失，不会干扰用户工作区
• 需处理网络请求错误（如超时、资源不存在），通过VS Code的提示组件给用户反馈

内容的提问来源于stack exchange，提问作者gnikit