VS Code Copilot Chat 复制内容为何丢失 Markdown 格式

很多人嫌装扩展麻烦，更偏爱一份脚本在手、随处可跑。下面这段 Node.js 脚本支持把 Chat: Export Chat... 得到的 JSON 文件转成 Markdown。脚本做了容错，兼容不同字段命名，遇到代码片段会用三引号围好，生成一个结构清晰的 Markdown 文件，方便直接存档或提交仓库。

使用步骤

1. 在 VS Code 命令面板执行 Chat: Export Chat...，保存为 chat.json。
2. 把下面脚本保存为 copilot-json-to-md.js。
3. 在 Node.js 18+ 环境运行：node copilot-json-to-md.js chat.json chat.md。
4. 打开生成的 chat.md 检查。

脚本源码

#!/usr/bin/env node
// 简易 Copilot Chat JSON -> Markdown 转换器
// 用法：node copilot-json-to-md.js input.json output.md

const fs = require('fs');
const path = require('path');

function asString(x) {
    if (x == null) return '';
    if (typeof x === 'string') return x;
    if (Array.isArray(x)) {
        // Copilot Chat 某些 schema 会把一条消息拆成多段 text / code
        return x.map(asString).join('\n');
    }
    if (typeof x === 'object') {
        // 尝试常见字段
        if (typeof x.text === 'string') return x.text;
        if (Array.isArray(x.text)) return x.text.map(asString).join('\n');
        if (typeof x.content === 'string') return x.content;
        if (Array.isArray(x.content)) return x.content.map(asString).join('\n');
        // 展开一下常见 content 块
        if (x.value && typeof x.value === 'string') return x.value;
        if (x.message && typeof x.message === 'string') return x.message;
        // 兜底序列化
        return '';
    }
    return String(x);
}

function normalizeBlocks(msg) {
    // 把一条消息拆成可渲染的文本段和代码段
    // 常见 schema：{ role: 'user' | 'assistant', content: [{type:'text', text:'...'}, {type:'code', text:'...'}] }
    const blocks = [];
    if (!msg) return blocks;
    const role = msg.role || msg.author || 'assistant';
    const content = msg.content ?? msg.message ?? msg.body ?? msg.parts ?? msg.items;

    if (Array.isArray(content)) {
        for (const part of content) {
            if (part == null) continue;
            const t = (part.type || part.kind || '').toLowerCase();
            const lang = part.language || part.lang || '';
            const text = asString(part);
            if (!text.trim()) continue;
            if (t.includes('code') || t.includes('snippet')) {
                blocks.push({ role, type: 'code', lang, text });
            } else {
                blocks.push({ role, type: 'text', text });
            }
        }
    } else {
        const text = asString(content ?? msg.text ?? msg.prompt ?? msg.response);
        if (text.trim()) {
            blocks.push({ role, type: 'text', text });
        }
    }
    return blocks;
}

function toMarkdown(chat) {
    const title = chat.title || 'Copilot Chat Export';
    const messages = chat.messages || chat.items || chat.history || chat.conversation || [];
    const lines = [];
    lines.push(`# ${title}`);
    lines.push('');

    for (const msg of messages) {
        const role = (msg.role || msg.author || '').toLowerCase();
        const who = role === 'user' ? 'User' : 'Copilot';
        const blocks = normalizeBlocks(msg);
        lines.push(`**${who}:**`);

        if (blocks.length === 0) {
            // 兜底尝试把整条消息序列化
            const raw = asString(msg);
            if (raw.trim()) lines.push(raw);
            lines.push('');
            continue;
        }

        for (const b of blocks) {
            if (b.type === 'code') {
                const lang = b.lang || '';
                lines.push('```' + lang);
                lines.push(b.text.replace(/\r\n/g, '\n'));
                lines.push('```');
                lines.push('');
            } else {
                lines.push(b.text.replace(/\r\n/g, '\n'));
                lines.push('');
            }
        }
    }
    return lines.join('\n');
}

function main() {
    const [, , input, output] = process.argv;
    if (!input) {
        console.error('用法：node copilot-json-to-md.js input.json [output.md]');
        process.exit(1);
    }
    const raw = fs.readFileSync(path.resolve(input), 'utf8');
    // 有些导出是数组，有些是对象
    const data = JSON.parse(raw);
    const doc = Array.isArray(data) ? { title: path.basename(input), messages: data } : data;
    const md = toMarkdown(doc);
    const out = output ? path.resolve(output) : path.resolve(process.cwd(), path.basename(input, path.extname(input)) + '.md');
    fs.writeFileSync(out, md, 'utf8');
    console.log('已生成:', out);
}

main();

如果你想跳过脚本，直接用社区现成方案，也可以用 peckjon/copilot-chat-to-markdown 仓库或 Chat To Markdown 扩展，流程与上面脚本一致。

一些看似诡异但常见的边角案例

• 在 Windows 或 macOS 上，某些富文本目标应用会优先读取剪贴板里的 HTML 或 RTF，而不是 text/plain。如果你从编辑器复制，且开启了 Copy With Syntax Highlighting，它们会粘出彩色代码；而从 Chat 右键 Copy 出来的 Markdown 只有 text/plain，因此看起来变朴素。这种差异是预期行为，不是内容丢了。
• 有用户反馈导出为 Markdown 或 PDF 的能力不足，这并不代表右键 Copy 不工作，而是一键导出整段对话为高质量文档这个场景目前还不完善。你可以用 Copy All 搭配 Markdown 编辑器，或走 JSON -> Markdown。
• 个别版本或 Insider 版在某些时间点出现过 Export Chat... 命令缺失或行为变化，这时候脚本路线就显得更稳。

结论与一条建议清单

当你说只能以纯文本拷贝，大多数情况下只是使用路径的问题：

• 需要 Markdown 源文本时，对着消息右键 -> Copy，不要依赖 Ctrl+C。
• 想要整段会话，试右键 -> Copy All，或 Chat: Export Chat... 然后本地转 Markdown。
• 如果目标应用不识别 Markdown，显示效果会像纯文本，这不等于你没复制到 Markdown。
• 若你追求富文本粘贴效果，那是 HTML/RTF 路线，与 Markdown 是两种需求；编辑器里的 Copy With Syntax Highlighting 只对编辑器文本生效，不直接影响 Chat。
• 需要可复现流程，随手保留上面的 Node.js 转换脚本，或使用社区扩展与仓库。

把这些点串起来，你就能在 VS Code 的 Copilot Chat、不同版本与不同目标应用之间，稳定地得到想要的 Markdown。当官方未来补全一键导出为 Markdown 或 PDF 的能力时，链路还会更顺滑；在那之前，右键 Copy 与 JSON -> Markdown 的两套方法足够覆盖绝大多数工作流。