使用Pandoc生成带有效链接引用的无Div Markdown文件问题

一、搞定引用链接失效 #

1. 别用过时的markdown-citations参数，直接用--citeproc启用Pandoc的官方引用处理功能。
2. 输出格式选gfm（GitHub Flavored Markdown），Hugo对这种格式的锚点和链接支持更靠谱：

   pandoc input.md --citeproc --bibliography=refs.bib --to gfm -o output.md
   

3. 检查你的BibTeX文件，保证每个bibkey唯一、没有特殊字符，不然锚点容易出问题。

二、去掉丑到爆的fenced_divs（:::格式） #

1. 加--no-native-divs参数，让Pandoc别生成那些奇怪的:::容器，改用标准的Markdown标题+列表来渲染参考文献：

   pandoc input.md --citeproc --bibliography=refs.bib --to gfm --no-native-divs --reference-section-title "参考文献" -o output.md
   

2. 如果还是有格式乱掉的情况，再加个--wrap=none禁止自动换行：

   pandoc input.md --citeproc --bibliography=refs.bib --to gfm --no-native-divs --wrap=none --reference-section-title "参考文献" -o output.md
   

三、Hugo那边配一下 #

1. 在Hugo的配置文件（config.toml或config.yaml）里开启GFM相关渲染支持：

   [markup.goldmark.parser]
     [markup.goldmark.parser.extensions]
       linkify = true
       strikethrough = true
       table = true
       taskList = true
       definitionList = true
   

2. 要是想让参考文献更好看，在Hugo的模板CSS里加几句样式：

   .refs-list {
     list-style: none;
     padding-left: 0;
   }
   .refs-list li {
     margin-bottom: 1rem;
     text-indent: -1.5rem;
     padding-left: 1.5rem;
   }
   

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