含Tikz图片的LaTeX文档转HTML失败：图片丢失问题求助

1. 安装必要依赖工具 #

diagram.lua滤镜需要将Tikz生成的PDF转换为网页支持的格式（SVG/PNG），必须先安装对应工具：

• pdf2svg（推荐，生成矢量图）：Linux发行版可通过包管理器安装（如apt install pdf2svg）；Windows/macOS可通过chocolatey、brew等包管理工具安装。
• 或ImageMagick：提供convert命令用于PDF转PNG，安装后需确保convert命令在系统PATH中。

2. 调整Pandoc转换命令 #

原命令缺少PDF引擎指定，修改为：

pandoc --standalone -N --lua-filter=diagram.lua --pdf-engine=lualatex -f latex -t html example.tex -o example.html

• --pdf-engine=lualatex：指定用LuaLaTeX编译Tikz代码，避免部分字体或Tikz库的兼容问题，也可替换为xelatex或pdflatex（根据你的环境选择）。

3. 验证滤镜文件路径 #

确保下载的diagram.lua文件在命令执行的当前目录下，若不在则需指定完整路径，例如：

--lua-filter=/home/user/scripts/diagram.lua

4. 排查兼容性与输出日志 #

• 先用极简Tikz代码测试，确认滤镜基础功能正常：

\begin{tikzpicture}
  \draw (0,0) -- (1,1);
\end{tikzpicture}

• 查看Pandoc转换时的终端输出，若有报错（如找不到编译工具、Tikz代码编译失败），根据提示针对性修复。

内容的提问来源于stack exchange，提问作者infcs.ltd