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,优先插入当前前台应用

快速安装

方式一:一体化安装包(推荐新手)

  1. 前往 Releases 页面 下载 PasteMD_pandoc-Setup.exe
  2. 运行安装包,一路下一步即可
  3. Pandoc 已内置,不需要单独安装

方式二:便携版

  1. 前往 Releases 页面 下载 PasteMD_vx.x.x.exe
  2. 确保本机已安装 Pandoc,且 Pandoc 命令可在命令行执行
  3. 若未安装 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,保留基本格式。


坑与注意

  1. ChatGPT 含公式的 Markdown 复制显示为代码:这是 ChatGPT 自身 Markdown 格式的问题,不是 PasteMD 的 bug。解决方案:复制时使用"网页内容复制"(HTML 模式)而非"复制 Markdown",或手动在 Word 中用公式编辑器处理。

  2. Kimi/通义千问的网页复制(含公式)无法显示公式:AI 网站本身限制,建议复制 Markdown 格式或手动补充公式。

  3. 首次运行需要手动修改配置:热键、路径等参数需要直接编辑 config.json,GUI 设置功能尚未完善。

  4. paste_delay_s 参数:部分 Windows 机器剪贴板写入有延迟,如果粘贴内容不完整或被截断,适当增大该值(如 0.5 或 1.0)。

  5. 便携版需要自行安装 Pandoc:如果运行报错先检查 Pandoc 是否在 PATH 中可用,在命令行运行 pandoc --version 验证。

  6. 升级版本前需清空旧数据:测试版期间数据库格式可能变化,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 用户体验最佳。