VSCode 配合 Pandoc 可高效实现 Markdown 与 Word、PDF、HTML 等格式双向转换:需先安装 Pandoc 并配置 PATH,再通过插件增强预览、用终端或 Tasks 自动化导出,注意 LaTeX 是 PDF 输出前提。

用 VSCode 配合 Pandoc,可以高效完成 Markdown、Word、PDF、HTML 等格式之间的双向转换,关键在于配置好环境和合理使用插件或命令行。
安装并验证 Pandoc
Pandoc 是核心转换工具,VSCode 本身不自带,需单独安装:
- 前往 pandoc.org/installing 下载对应系统的安装包(Windows/macOS/Linux 均支持)
- 安装完成后,在终端运行
pandoc --version,确认输出版本号(如 3.1.10) - 确保 Pandoc 被加入系统 PATH,否则 VSCode 的集成终端可能找不到命令
在 VSCode 中编辑与预览 Markdown
VSCode 原生支持 Markdown 编辑和实时预览(Ctrl+Shift+V 或右键 → “Open Preview”),但要获得更接近最终输出的样式,可:
- 安装扩展 Markdown All in One(增强快捷键、目录、导出等)
- 安装 Markdown Preview Enhanced(支持数学公式、Mermaid 图表、本地 PDF 导出)
- 用快捷键
Ctrl+K V快速开启侧边预览,支持同步滚动
用终端或任务快速调用 Pandoc 转换
无需离开 VSCode,直接在内置终端(Ctrl+`)执行 Pandoc 命令即可:
- 转为 PDF(需已安装 LaTeX,如 TinyTeX 或 TeX Live):
pandoc input.md -o output.pdf - 转为 Word:
pandoc input.md -o output.docx - 转为带样式的 HTML(含 CSS):
pandoc input.md -s -o output.html(-s表示生成完整 HTML 页面) - 指定模版或元数据(例如添加标题、作者):
pandoc input.md --metadata title="我的文档" --metadata author="张三" -o output.pdf
自动化:用 VSCode Tasks 简化常用转换
把高频命令保存为任务,一键运行(Ctrl+Shift+P → “Tasks: Run Task”):
- 在工作区根目录创建
.vscode/tasks.json - 添加一个导出 PDF 的任务,例如:
{
"version": "2.0.0",
"tasks": [
{
"label": "Export to PDF",
"type": "shell",
"command": "pandoc",
"args": ["${file}", "-o", "${fileBasenameNoExtension}.pdf"],
"group": "build",
"presentation": { "echo": true, "reveal": "always", "focus": false }
}
]
}
保存后,打开任意 .md 文件,按 Ctrl+Shift+B 即可生成同名 PDF。
基本上就这些。环境搭好后,日常写作→预览→导出,全程在 VSCode 内完成,不复杂但容易忽略 PATH 和 LaTeX 依赖这两个关键点。










