Pandoc转换MD为DOCX/ODT时标题出现淡括号问题求助

环境 #

• Pandoc 3.2.1（支持+server +lua，Lua 5.4脚本引擎）
• Windows 11 Pro（版本10.0.26120 Build 26120）

已验证现象 #

• 直接终端运行pandoc minimal.md -o minimal.docx转换极简Markdown文件，标题仍出现淡括号
• 转换为ODT格式存在同样问题，二级标题括号为斜体
• 先转HTML再转DOCX，HTML正常但DOCX仍出现淡括号
• 排除Wiki链接问题，仅带#的标题位置出现该现象

解决方案 #

一、转换阶段避免淡括号的方法 #

1. 使用Pandoc默认模板转换

默认情况下Pandoc不会给标题添加此类标记，大概率是自定义模板导致的。导出默认模板并使用它转换：

# 导出默认DOCX模板
pandoc --print-default-data-file reference.docx > default-reference.docx
# 使用默认模板转换
pandoc minimal.md --reference-doc=default-reference.docx -o minimal-fixed.docx

2. 禁用所有Lua过滤器

若你的Pandoc自动加载了全局或本地Lua过滤器，可能会篡改标题格式，尝试禁用所有过滤器：

pandoc --no-filter minimal.md -o minimal-no-filter.docx

如果问题消失，排查当前目录或用户配置目录下的.lua脚本，找到导致问题的过滤器并移除/修改。

3. 忽略Pandoc配置文件

检查是否有全局配置文件（如用户目录下的pandoc.yaml）自定义了转换规则，尝试忽略所有配置：

pandoc --defaults=none minimal.md -o minimal-no-config.docx

二、清除已生成文档中淡括号的方案 #

这些淡括号并非实际文本，是Word/ODT的样式标记或隐藏格式提示，可通过以下步骤清除：

针对DOCX（Word）

1. 点击「开始」选项卡→「段落」组中的「显示/隐藏编辑标记」按钮（图标为¶），若括号是编辑标记，点击后会直接隐藏；
2. 若仍存在，右键标题→「修改样式」→「格式」→「字体」，取消勾选「隐藏」选项；
3. 检查段落边框：右键标题→「段落」→「边框和底纹」，确认是否有误设的边框样式模拟了括号。

针对ODT（LibreOffice Writer）

1. 点击「视图」选项卡，取消勾选「格式标记」；
2. 右键标题→「段落」→「边框」，检查是否有自定义边框设置为括号样式；
3. 右键标题→「字体」，确认未勾选「隐藏」属性。

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