如何阻止Pandoc移除Markdown标题中的前导下划线？

算力阿峰

2026-6-16

解决Pandoc标题前导下划线被移除导致链接失效的问题

有两种实用的解决方式：

强制指定标题ID：在Markdown标题末尾添加自定义ID属性，直接固定ID值，不受Pandoc默认清理规则影响。
执行命令示例：
```
$ pandoc -f markdown - <<<'Go to [_section](#_section)'$'\n\n''### _section {#_section}'
```
生成的HTML会正确匹配ID：
```
<p>Go to <a href="#_section">_section</a></p>
<h3 id="_section">_section</h3>
```
修改Pandoc的slug生成规则：如果需要批量处理这类标题，可通过slugify-mode元数据选项设置为raw，让Pandoc保留标题中的原始字符（包括前导下划线）。
执行命令示例：
```
$ pandoc -f markdown - --metadata=slugify-mode:raw <<<'Go to [_section](#_section)'$'\n\n''### _section'
```
此命令会生成带前导下划线的标题ID，确保链接能准确定位到目标标题。