Pandoc可实现VSCode中Markdown学术文档到PDF/Word/HTML的高质量转换：需安装Pandoc与MacTeX，配置VSCode扩展及路径，编写含YAML元数据的Markdown文件，定制LaTeX模板，并支持多格式批量导出。
如果您在VSCode中使用Markdown编写学术文档，但需要生成格式规范的PDF或Word报告，Pandoc可作为核心转换引擎实现高质量排版输出。以下是构建该工作流的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装Pandoc与LaTeX引擎
VSCode本身不内置文档格式转换能力，需依赖系统级Pandoc及LaTeX支持以生成PDF。缺少任一组件将导致PDF导出失败或样式错乱。
1、访问pandoc.org，下载并安装最新稳定版Pandoc macOS安装包。
2、使用Homebrew执行brew install --cask mactex安装完整版MacTeX（含pdflatex、xelatex等）。
3、在终端运行pandoc --version与pdflatex --version，确认两者均返回版本信息。
二、配置VSCode扩展与设置
需启用Markdown预览增强与Pandoc命令集成，使编辑、预览与导出在统一界面完成，避免频繁切换终端。
1、在VSCode扩展市场中搜索并安装“Markdown All in One”与“Pandoc”两个扩展。
2、打开VSCode设置（Cmd+,），搜索markdown.preview.breaks，勾选以启用换行转
。
3、进入设置JSON文件（Cmd+Shift+P → “Preferences: Open Settings (JSON)”），添加以下配置项：
"pandoc.executable": "/opt/homebrew/bin/pandoc"（路径需与实际安装位置一致）
"markdown.extension.print.enable": true
三、编写带元数据的Markdown源文件
学术写作需标题、作者、日期、参考文献等结构化元数据，Pandoc通过YAML区块识别并注入PDF/Word模板头部信息。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
1、新建report.md文件，在首段前插入YAML元数据块，以三个短横线起止：
---\ntitle: \"基于深度学习的图像分类方法研究\"\nauthor: \"张明\"\ndate: \"2024-09-15\"\ngeometry: margin=1in\nbibliography: references.bib\n---
2、正文使用标准Markdown语法，公式用$...$或$$...$$包裹，表格采用管道符格式，引用用@key形式（如@he2023attention）。
3、保存后右键选择“Pandoc: Export to PDF”，触发自动调用xelatex生成PDF。
四、定制PDF输出样式
Pandoc默认PDF样式偏简朴，学术场景需调整字体、章节编号、页眉页脚等，可通过LaTeX模板或变量控制。
1、创建custom.tex模板文件，覆盖默认article.cls，加入ctex包支持中文与\songti字体声明。
2、在YAML元数据中添加template: custom.tex字段指定模板路径。
3、导出时追加变量参数：pandoc report.md -o report.pdf --pdf-engine=xelatex -V mainfont="Noto Serif CJK SC"。
五、批量生成多格式交付物
同一份Markdown源文件可按需输出PDF、DOCX、HTML三种格式，满足投稿、汇报、网页发布不同场景需求，无需重复编辑。
1、在VSCode中右键文件，依次选择“Pandoc: Export to DOCX”生成兼容Word审阅模式的文档。
2、执行命令面板（Cmd+Shift+P）→ 输入“Pandoc: Export to HTML”，输出含内联CSS的响应式页面。
3、对含参考文献的文件，确保references.bib为BibTeX格式，并在导出PDF时添加--citeproc参数启用引用解析。
