用途：在 Markdown、Word（.docx）、HTML、PDF 之间进行格式转换，开箱即用支持中文，避免中文乱码。
主要能力：支持 Markdown→PDF/Word/HTML、Word→Markdown/PDF、HTML→Markdown/Word/PDF；PDF 不能作为输入（pandoc 限制）。附带脚本：convert-to-pdf.sh 生成带 CJK 等宽字体、11pt、1.5cm 页边距的 PDF，推荐用于所有 PDF 转换；fix-ascii-art.py 在转 Word 前对齐 ASCII 图宽度。
使用方式：先确认源文件路径与格式、目标格式及选项，再执行 pandoc 命令。PDF 推荐命令：bash ~/.agents/skills/pandoc-converter/scripts/convert-to-pdf.sh input.md；手动示例：pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont="PingFang SC" -V monofont="Sarasa Fixed SC" -V geometry:margin=2cm。Word：先运行 python3 ~/.agents/skills/pandoc-converter/scripts/fix-ascii-art.py input.md --check 检查，再转换 pandoc input.md -o output.docx --reference-doc=~/.agents/skills/pandoc-converter/references/reference.docx。Markdown：pandoc input.docx -o output.md --extract-media=./media --wrap=none。HTML：pandoc input.md -o output.html --standalone，可加 --css 或 --embed-resources。HTML 输入转 PDF/Markdown 时同样指定引擎或 --wrap=none。批量转换可用 for 循环对 *.md 重复相同选项。除非指定输出路径，输出默认与输入同目录、同基本名、换新扩展名。
适用场景：需要发布 PDF/Word 文档、整理 Word 到 Markdown、生成独立 HTML 等技术文档处理。
限制：PDF 不能作为输入；中文 PDF 必须用 --pdf-engine=xelatex 并配 CJK 字体；字体缺失可用 fc-list :lang=zh 查看；缺少 LaTeX 包用 tlmgr install 安装；覆盖前需检查目标文件是否存在，路径加引号，只读源文件不修改原文件。更多字体、语法高亮、数学公式、PDF 特性与高级用法见 references 下对应文件。