使用 pandoc 保留标题中的换行符

Question

考虑一下 pandoc 风格的 Markdown 中的以下标题栏：

% Higgelty Pigglety Pop!
  or
  There Must Be More to Life
% Maurice Sendak

在这里，换行符是标题的一部分。可以重新格式化标题以将其插入常规文本流中，例如“Higgelty Pigglety Pop！或者，生活中必须有更多”，但是当不被提及但在文档的标题页上使用时，保留换行符至关重要。根据样式，它可能如下所示：

Higgelty Pigglety 流行音乐！ 或者 生活必须不止于此 莫里斯·森达克

我的问题：如何在 pandoc 的输出中实现正确的多行标题显示？

便携式版本会是首选，但我也会满足于仅使用 LaTeX 的 hack。

Answer 1

% Higgelty Pigglety Pop! \
  or \
  There Must Be More to Life
% Maurice Sendak

Pandoc Markdown 默认启用escaped_line_breaks extension：

反斜杠后跟换行符也是硬换行符。注意：在多行和网格表格单元格中，这是创建硬换行符的唯一方法，因为单元格中的尾随空格会被忽略。

Answer 2

使用 YAML 元数据块时，也可以使用以下方法：

---
title: |
    | First line
    | Second line
---

在this thread 中发现了这个想法。

Answer 3

一种非常通用但不太简单的方法是使用原始 HTML 来指示换行符，并使用 pandoc filter 将它们转换为正确的换行符。下面是一个Lua filter，它将源代码中的任何<br>（或<br />）转换为硬换行符。

--- Transform a raw HTML element which contains only a `<br>`
-- into a format-indepentent line break.
function RawInline (el)
  if el.format:match '^html' and el.text:match '%<br ?/?%>' then
    return pandoc.LineBreak()
  end
end

将文件另存为linebreaks.lua。

标题可以写成

% Higgelty Pigglety Pop!<br>or<br>There Must Be More to Life
% Maurice Sendak

以上脚本必须通过--lua-filter选项传递给pandoc：

$ pandoc -o test.pdf --lua-filter ./linebreaks.lua test.md

这种方法的优点是它更通用，并且也适用于人们可能想要添加换行符的其他位置。例如，可以使用相同的语法在标题中添加换行符：# first line<br>second line。