RICHQAQ/PasteMD · 上手攻略
- 仓库:RICHQAQ/PasteMD
- 链接:https://github.com/RICHQAQ/PasteMD
- 分类:效率工具 · 文档转换
- 作者:Tom
- 更新:2026-07-14
这是什么
PasteMD 是一款常驻系统托盘的 Windows 小工具,核心功能只有一个:把剪贴板里的 Markdown 或网页 AI 对话内容,一键转换为 Word/WPS 兼容的 DOCX 格式,并直接插入光标位置。
它的设计目标是解决一个非常具体的痛点:写论文或报告时,从 ChatGPT、DeepSeek、Claude 等 AI 对话网站复制出来的内容(尤其是数学公式和 Markdown 表格),直接粘贴到 Word 里要么乱码、要么格式全毁。PasteMD 用 Pandoc 作为转换内核,绕过了这个长期困扰文字工作者的难题。
该工具支持 Windows 系统,需要搭配 Pandoc 使用(便携版需自行安装 Pandoc,一体化安装包则自带 Pandoc,无需额外配置)。
解决什么问题
| 痛点 | PasteMD 的解法 |
|---|---|
| AI 输出的 Markdown 表格直接粘贴到 Excel 格式全乱 | 智能识别 Markdown 表格,自动粘贴到已打开的 Excel,光标放在哪里就贴到哪里 |
| ChatGPT 输出的数学公式在 Word 里显示为代码 | 调用 Pandoc 转换,保留 LaTeX 公式渲染(部分 AI 网站如 ChatGPT 的 Markdown 含公式会显示为代码,需手动处理) |
| 网页复制过来的 AI 回复含 HTML 格式,Word 里版式走样 | HTML 富文本识别模式,智能清洗格式后转换为 DOCX |
| 不同 AI 网站复制出来的内容格式不统一 | 内置多网站兼容性测试表(DeepSeek、ChatGPT、Claude、Gemini 等均已覆盖),用户可自行判断效果 |
| 想把 Markdown 粘贴到 WPS,但格式出错 | 自动识别 Word/WPS,优先插入当前前台应用 |
快速安装
方式一:一体化安装包(推荐新手)
- 前往 Releases 页面 下载
PasteMD_pandoc-Setup.exe - 运行安装包,一路下一步即可
- Pandoc 已内置,不需要单独安装
方式二:便携版
- 前往 Releases 页面 下载
PasteMD_vx.x.x.exe - 确保本机已安装 Pandoc,且 Pandoc 命令可在命令行执行
- 若未安装 Pandoc,前往 pandoc.org/installing.html 下载安装
⚠️ 截至本文更新,Releases 页面仅提供源码,需自行编译。 Releases 列表中已无便携版 exe,建议优先下载一体化安装包。如 Releases 页面无可用 exe,可自行 clone 仓库用 cargo build 或其他方式编译。
核心用法
基础操作流程
1. 打开 Word、WPS 或 Excel,将光标放在需要插入内容的位置
2. 在 AI 对话网站(如 DeepSeek、ChatGPT)点击"复制"获取 Markdown,或选中文字直接复制(获取 HTML 富文本)
3. 按下全局热键 Ctrl+Shift+B
4. 等待右下角系统通知提示成功/失败
5. 内容自动插入光标位置(Markdown 表格 → Excel,普通内容 → Word/WPS)
智能识别逻辑
- Markdown 表格 + Excel 已打开 → 自动粘贴到 Excel,保留粗体、斜体、代码等格式
- 普通 Markdown / HTML 富文本 → 转换为 DOCX 插入 Word 或 WPS
- 未检测到目标应用 → 默认行为可通过
config.json中的no_app_action配置为:自动打开应用(open)、仅保存文件(save)、复制文件到剪贴板(clipboard)或无操作(none)
全局热键
默认热键为 Ctrl+Shift+B,可在 config.json 中修改:
{
"hotkey": "<ctrl>+<shift>+b"
}
热键语法参考类似格式,如 <ctrl>+<shift>+v 即 Ctrl+Shift+V。
配置文件路径
首次运行后,配置保存在用户数据目录:
- Windows:
%APPDATA%\PasteMD\config.json - macOS:
~/Library/Application Support/PasteMD/config.json
配置详解
PasteMD 的 config.json 提供了丰富的可调参数,以下是主要选项说明:
{
"pandoc_path": "pandoc",
"reference_docx": null,
"save_dir": "%USERPROFILE%\\Documents\\pastemd",
"keep_file": false,
"notify": true,
"startup_notify": true,
"enable_excel": true,
"excel_keep_format": true,
"paste_delay_s": 0.3,
"no_app_action": "open",
"md_disable_first_para_indent": true,
"html_disable_first_para_indent": true,
"move_cursor_to_end": true,
"Keep_original_formula": false,
"enable_latex_replacements": true,
"fix_single_dollar_block": true,
"language": "zh-CN"
}
| 参数 | 作用 | 建议值 |
|---|---|---|
pandoc_path |
Pandoc 可执行文件路径 | 默认 "pandoc",PATH 已配置则无需修改 |
reference_docx |
Pandoc 参考模板路径 | 可填入 .docx 模板文件路径以统一文档样式 |
save_dir |
保留文件时的保存目录 | 可自定义 |
keep_file |
是否保留生成的 DOCX 文件 | false(仅粘贴,不保存文件) |
enable_excel |
是否启用 Markdown 表格→Excel 粘贴 | true |
excel_keep_format |
Excel 粘贴时是否保留 Markdown 格式(粗体、斜体等) | true |
paste_delay_s |
粘贴前延迟秒数 | 0.3(部分 Windows 机器剪贴板写入需要时间,可适当增大) |
fix_single_dollar_block |
自动将单独一行的 $ ... $ 公式块转为 $$ ... $$ |
true |
language |
界面语言 | zh-CN / en-US / ja-JP |
按应用配置粘贴模式
可通过 extensible_workflows 为不同应用配置不同的粘贴行为:
{
"extensible_workflows": {
"html": {
"enabled": true,
"apps": ["语雀", "飞书"]
},
"md": {
"enabled": true,
"apps": ["Notion"]
}
}
}
典型使用场景
场景一:写论文时引用 AI 输出的公式和表格
在 DeepSeek 中生成了一段数学推导和对比表格,直接复制粘贴到 Word,公式正常显示、表格保留格式。
适用 AI:DeepSeek ✅ | Claude ✅ | Gemini ✅ | ChatGPT ⚠️(含公式时显示为代码)
场景二:把 ChatGPT 的 Markdown 回复整理进 WPS 文档
在 ChatGPT 页面全选复制(HTML 模式),Ctrl+Shift+B 粘贴进 WPS,Pandoc 自动处理格式。
⚠️ 注意:ChatGPT 的 Markdown 复制模式(含公式)会将公式显示为代码,建议用 HTML 复制模式。
场景三:把 AI 输出的表格直接粘贴到 Excel
Markdown 表格复制后,如果 Excel 处于前台窗口且光标在单元格内,工具会自动识别并粘贴到 Excel,保留基本格式。
坑与注意
-
ChatGPT 含公式的 Markdown 复制显示为代码:这是 ChatGPT 自身 Markdown 格式的问题,不是 PasteMD 的 bug。解决方案:复制时使用"网页内容复制"(HTML 模式)而非"复制 Markdown",或手动在 Word 中用公式编辑器处理。
-
Kimi/通义千问的网页复制(含公式)无法显示公式:AI 网站本身限制,建议复制 Markdown 格式或手动补充公式。
-
首次运行需要手动修改配置:热键、路径等参数需要直接编辑
config.json,GUI 设置功能尚未完善。 -
paste_delay_s 参数:部分 Windows 机器剪贴板写入有延迟,如果粘贴内容不完整或被截断,适当增大该值(如 0.5 或 1.0)。
-
便携版需要自行安装 Pandoc:如果运行报错先检查 Pandoc 是否在 PATH 中可用,在命令行运行
pandoc --version验证。 -
升级版本前需清空旧数据:测试版期间数据库格式可能变化,docker compose 方式升级时建议先
docker compose down -v清数据。
与同类对比
| 工具 | 转换引擎 | Excel 表格支持 | 公式支持 | 系统要求 | 特色 |
|---|---|---|---|---|---|
| PasteMD | Pandoc | ✅ 智能识别 | ✅ LaTeX 渲染 | Windows + Pandoc | AI 对话格式专项优化 |
| Mark Text | 原生渲染 | ❌ 不支持 | ✅ 支持 | 全平台 | Markdown 编辑器,非粘贴工具 |
| Pandoc CLI 手动转换 | Pandoc | 需手动指定 | ✅ 支持 | 全平台 | 灵活但需要命令行操作 |
| Word 插件 Markdown All in One | JS 渲染 | ❌ 不支持 | ⚠️ 部分支持 | Windows Word | 在 Word 内写 Markdown |
PasteMD 的核心差异在于专为 AI 对话输出优化,尤其是对 DeepSeek、Claude 等主流 AI 的格式兼容测试,以及 Markdown 表格到 Excel 的智能路由。
一句话推荐结论
如果你经常需要把 AI 输出的内容整理到 Word/Excel 文档中,PasteMD 是目前 Windows 平台上最省心的方案——安装简单、热键一键搞定,DeepSeek 和 Claude 用户体验最佳。