用途:使用 Pandoc 在常见文档格式之间转换文件,适合需要把 Markdown、Word、HTML、PDF、LaTeX、EPUB、RTF、PPTX 等互相转换的场景。
主要能力:支持文档格式的读写转换,包括 markdown、html、docx、latex、epub、rtf、pptx、pdf;数据格式 csv、tsv、xlsx 仅支持读取,可转换为其他格式中的表格;支持 gfm、commonmark 等 Markdown 变体。
使用方式:基本转换 python scripts/convert.py input.md output.docx;仅指定输出格式 python scripts/convert.py document.md --to html;检查是否安装 Pandoc 用 python scripts/convert.py --check;列出支持格式用 python scripts/convert.py --formats。常用选项包括 --from、--to、--standalone、--toc、--pdf-engine(pdflatex、xelatex、lualatex),其余 Pandoc 选项可直接透传。
安装:macOS 用 brew install pandoc;Ubuntu/Debian 用 sudo apt-get install pandoc。生成 PDF 还需安装 LaTeX,例如 macOS 用 brew install --cask mactex-no-gui,Ubuntu 用 sudo apt-get install texlive-xetex。
限制:CSV/TSV/XLSX 仅作为输入;PDF 输出依赖 LaTeX;PPTX 可提取文本,但复杂版式可能被简化;复杂格式在跨格式转换时部分特性可能无法保留。具体兼容性可参考 references/format-compatibility.md。