用途:为使用 Pandoc 将 Markdown 转换为 PDF、DOCX、HTML 及演示文稿提供辅助,覆盖 YAML frontmatter 校验、参考文献配置、模板生成与按格式的转换指引。
主要能力:校验 YAML frontmatter 与依赖(脚本 scripts/validate.py);内置模板包括 academic-paper.yaml、thesis-report.yaml、presentation-beamer.yaml、presentation-revealjs.yaml、article-simple.yaml、defaults-pdf.yaml、references.bib、Makefile;内置引用样式 harvard.csl、apa.csl、ieee.csl,可直接复制到项目使用;提供 references 下的转换指南、YAML 变量、模板指南与故障排查文档。
使用方式:先校验再转换。示例命令:python3 "$PLUGIN_DIR/skills/pandoc/scripts/validate.py" document.md;转换示例:pandoc document.md -o document.pdf --pdf-engine=pdflatex --number-sections --citeproc;HTML:pandoc document.md -o document.html --standalone --self-contained --toc;DOCX:pandoc document.md -o document.docx --standalone;演示文稿:pandoc slides.md -o slides.pdf --to beamer 或 pandoc slides.md -o slides.html --to revealjs --standalone。用户可使用命令 /pandoc:template、/pandoc:validate、/pandoc:convert、/pandoc:frontmatter、/pandoc:restyle、/pandoc:defaults。
适用场景:学术论文、论文/报告、博客转论文、OCR/PDF 转学术格式、带引用与参考文献的文档、演示文稿。
限制:仅用于 Pandoc,不适用于简单 Markdown 渲染/预览或其他转换器,也不处理与转换无关的 Markdown 语法问题。PDF 依赖 LaTeX,可能需安装 texlive 包;Unicode 报错时可改用 --pdf-engine=xelatex。插件仅内置 Harvard、APA、IEEE 引用样式,其他样式需从外部获取。其他收费、平台与效果信息暂未提供。