Laravel中如何用Pandoc将LaTeX数学公式转为Word可编辑OMML格式？

1. 确认Pandoc版本 #

先在终端执行命令查看当前版本：

pandoc -v

• Pandoc 2.0及以上版本支持将$...$（行内公式）和$$...$$（块级公式）的LaTeX语法转为Word原生OMML，但需明确启用公式解析；
• 低于2.0的版本建议升级到官方稳定版，避免兼容性问题。

2. 调整Pandoc命令参数 #

默认情况下Pandoc不会自动识别美元符号包裹的公式，需添加参数强制启用TeX数学解析：

pandoc input.md --from=markdown+tex_math_dollars --to=docx -o output.docx

• --from=markdown+tex_math_dollars：明确开启对$和$$包裹的LaTeX公式的解析规则；
• 无需额外指定--mathml或--mathjax，Pandoc输出docx时会自动将解析后的TeX公式转为原生可编辑的OMML格式。

3. Laravel中代码实现 #

使用Laravel的Process组件执行命令时，正确传递参数即可：

use Illuminate\Support\Facades\Process;
use Symfony\Component\Process\Exception\ProcessFailedException;

// 定义输入输出文件路径
$inputMarkdown = storage_path('temp/question.md');
$outputDocx = storage_path('temp/question.docx');

// 构建Pandoc命令数组
$command = [
    'pandoc',
    $inputMarkdown,
    '--from=markdown+tex_math_dollars',
    '--to=docx',
    '-o',
    $outputDocx
];

try {
    $process = Process::run($command);

    if (!$process->successful()) {
        throw new ProcessFailedException($process);
    }

    // 返回下载响应，下载后自动删除临时文件
    return response()->download($outputDocx)->deleteFileAfterSend(true);
} catch (ProcessFailedException $e) {
    return response()->json(['error' => '公式转换失败：' . $e->getMessage()], 500);
}

4. 关键注意事项 #

• 公式格式规范：确保Markdown中的公式符合标准：
  • 行内公式$E = mc^2$不要混入多余空格或错误转义字符；
  • 块级公式$$\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}$$需单独占一行，前后无其他文本干扰。
• 环境检查：服务器需安装完整的Pandoc环境，部分精简安装包可能缺失公式转换组件，建议从官方渠道重新安装。

排错指南 #

若转换后公式仍异常：

1. 直接在服务器终端执行上述Pandoc命令，验证是否为Laravel代码逻辑问题；
2. 通过$process->errorOutput()查看Pandoc的错误日志，定位公式语法或解析规则冲突问题；
3. 用极简测试文件（仅包含1个行内公式+1个块级公式）排查是否为特定公式的语法错误。

内容的提问来源于stack exchange，提问作者Otmane Hammadi