Pandoc 文档转换技能
该技能提供使用 Pandoc 进行文档格式转换的工作流程和最佳实践
何时使用此技能
当用户提出以下需求时，使用此技能：
- 需要将文档从一种格式转换为另一种格式（例如 Markdown 转换为 DOCX、PDF、HTML 等）
- 需要处理包含特殊内容（如 Mermaid 图表）的 Markdown 文件
工作流程
- 环境检查：
- 运行 Bash 命令 pandoc --version 检查系统中是否已经安装了 Pandoc。 - 如果系统未安装 Pandoc，请先按照 Pandoc 安装指南 进行安装。
- 验证安装：
- 若进行了安装，请再次执行 pandoc --version 验证是否安装成功。
- 执行转换：
- 根据用户的要求，构建 pandoc 命令并执行转换。 - 注意：在执行转换前，请务必查看下方“最佳实践”以应对特殊内容（如 Mermaid 图表）。
最佳实践
处理 Markdown 中的 Mermaid 图表
如果源文件是 Markdown (.md) 格式，在转换之前：
- 必须先检查 源文件中是否包含 Mermaid 图表（即 ```
mermaid代码块）。 - 如果包含 Mermaid 图表，执行转换时必须使用 Lua 过滤器将其渲染为图片，否则图表会丢失或显示异常。
- 请直接使用技能
scripts/目录中已经准备好的mermaid-to-image.lua文件，不要重新编写该脚本。
转换命令示例（假设当前命令在项目根目录执行）：
pandoc "源文档.md" --lua-filter="D:/Sources/cruldra-skills/skills/pandoc/scripts/mermaid-to-image.lua" -o "输出文档.docx"*(提示：在使用时请将过滤器路径替换为当前环境中 mermaid-to-image.lua 的实际绝对路径。)*