如何将Asciidoc转换为无冗余格式的LaTeX以适配现有工具链？

我之前处理文档工具链的时候也踩过同样的坑——原生Asciidoc转LaTeX不靠谱，dblatex出来的东西又堆满了冗余格式，完全和现有流程冲突。下面是几个亲测有效的解决办法：

1. 用Pandoc直接转（最省心的选择） #

Pandoc对Asciidoc的解析很到位，而且能通过参数精准控制LaTeX输出的简洁度。试试这条命令：

pandoc -s input.adoc -o output.tex --no-highlight

• -s 生成带基础文档结构的独立LaTeX文件，但不会乱加页边距、字体这类额外设置；
• --no-highlight 会去掉代码块的默认高亮格式（如果你的工具链自己处理代码高亮，这个参数一定要加）；
• 如果需要指定基础文档类（比如article），可以再加--variable=documentclass:article，避免Pandoc默认的一些冗余配置。

Pandoc会把Asciidoc里的语义化标记（比如*粗体*、_斜体_、标题层级）精准映射成对应的LaTeX命令，不会添加任何你没在文档里明确指定的格式，完美适配自定义工具链。

2. 自定义Asciidoctor的LaTeX模板（自由度最高） #

Asciidoctor作为Asciidoc的增强实现，支持自定义模板来完全控制LaTeX输出。步骤如下：

• 先导出默认的LaTeX模板：

asciidoctor-latex --dump-template > custom-template.erb

• 打开这个模板文件，删掉所有你不需要的冗余内容——比如字体定义、页面布局、默认页眉页脚、多余的包引用等，只保留核心的结构映射（比如标题对应\section，列表对应itemize，粗体对应\textbf）；
• 用自定义模板转换文档：

asciidoctor-latex -t custom-template.erb input.adoc -o output.tex

这种方法能让你完全按照工具链的需求定制输出，不过需要你对ERB模板语法和LaTeX有一定基础。

3. 先转Markdown再转LaTeX（备选方案） #

如果上面两种方法都不适用，可以走“Asciidoc → Markdown → LaTeX”的路线：

# 先把Asciidoc转成干净的Markdown
asciidoctor -b markdown input.adoc -o temp.md
# 再用Pandoc转LaTeX
pandoc -s temp.md -o output.tex --no-highlight

Asciidoctor转Markdown的时候只会保留最核心的文本格式，不会带任何多余样式，再转LaTeX就能得到极度简洁的输出，完全不会和你的工具链冲突。

最后提醒一句：不管用哪种方法，尽量在Asciidoc文档里使用语义化标记（比如用== 二级标题而不是手动设置字体大小），这样转换出来的LaTeX才是纯粹的结构化内容，没有冗余格式。

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