VS Code中Markdown Preview Enhanced导出Reveal.js的问题

1. Pandoc导出「需指定输出格式」错误修复 #

这个错误是因为Pandoc无法自动识别你要导出的文件格式，只需在Markdown文档头部的YAML配置块里指定output字段即可。比如导出Word的配置示例：

---
output:
  word_document:
    path: ./导出的文档.docx
---

2. 导出Reveal.js格式HTML文件的正确配置 #

如果要导出Reveal.js幻灯片，用custom_document配合pandoc_args的配置如下，核心是通过参数指定输出格式为revealjs：

---
output:
  custom_document:
    path: ./幻灯片.html
    pandoc_args:
      - -t
      - revealjs
      - -s
      - --self-contained
---

• -t revealjs：明确告诉Pandoc输出Reveal.js格式
• -s：生成独立的HTML文件
• --self-contained：把所有依赖的CSS、JS资源打包进单个HTML文件

3. 右键Reveal.js选项无效的原因与生效方法 #

右键菜单里的Reveal.js主题切换、导航控制等选项，只对插件内置的Reveal.js预览模式生效，和Pandoc导出的文件无关。要让这些选项生效并在预览窗口看到Reveal.js渲染效果，按以下步骤操作：

• 打开Markdown文件后，用快捷键Ctrl+Shift+P唤起命令面板，输入Markdown Preview Enhanced: Open Preview to the Side打开预览窗口，然后点击预览窗口右上角的「幻灯片」图标切换到Reveal.js预览模式。
• 在文档头部添加revealjs专属配置字段，替代Pandoc参数来控制幻灯片属性，示例：

---
revealjs:
  theme: black
  transition: fade
  controls: true
---

此时再用右键菜单修改主题、切换过渡效果等，预览窗口会实时刷新生效。

如果需要同时保留导出功能和预览功能，可以在YAML里同时配置output和revealjs字段，两者互不冲突。

内容的提问来源于stack exchange，提问作者Joshua Muheim