如何让Pandoc自动识别文档中的ragged right属性？

核心思路 #

Pandoc默认不会将DOCX/ODT/HTML中的段落对齐属性直接转换为LaTeX的对齐命令，需要通过Lua过滤器捕获对齐信息并生成对应的LaTeX代码，这是最灵活且通用的解决方案。

步骤1：编写对齐处理Lua过滤器 #

创建一个名为align-filter.lua的文件，内容如下：

-- 处理段落级对齐
function Para(p)
  local align = p.attr.attributes['alignment']
  if align == 'right' then
    return pandoc.RawBlock('latex', '\\begin{flushright}') .. p .. pandoc.RawBlock('latex', '\\end{flushright}')
  elseif align == 'center' then
    return pandoc.RawBlock('latex', '\\begin{center}') .. p .. pandoc.RawBlock('latex', '\\end{center}')
  -- 左对齐为LaTeX默认，无需额外处理，如需可自行添加
  else
    return p
  end
end

-- 处理行内级对齐（可选，若有局部文本右对齐需求）
function Span(s)
  local align = s.attr.attributes['text-align']
  if align == 'right' then
    return pandoc.RawInline('latex', '\\raggedleft ') .. s.content .. pandoc.RawInline('latex', '\\normalalign')
  end
  return s
end

步骤2：执行转换命令 #

使用以下命令进行格式转换，替换对应的输入输出文件名：

# DOCX转TeX
pandoc input.docx -o output.tex --lua-filter=align-filter.lua

# ODT转TeX
pandoc input.odt -o output.tex --lua-filter=align-filter.lua

# HTML转TeX
pandoc input.html -o output.tex --lua-filter=align-filter.lua

关键注意事项 #

• 确保原文档中的右对齐是段落级原生对齐设置，而非通过空格、制表位手动缩进实现，这类手动操作Pandoc无法识别。
• 若使用LaTeX的article等标准文档类，flushright环境会自动处理段落间距，无需额外调整。
• 如需全局修改对齐样式，可结合自定义LaTeX模板，但Lua过滤器更适合批量处理不同格式的输入文件。

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