Question

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

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

此处，换行符是标题的一部分。可以重新格式化标题以便将其插入常规文本流中，例如， “Higgelty Pigglety Pop！或者，必须有更多生命”，但如果没有谈到但是在文档的标题页上使用，保留换行符是至关重要的。根据样式，它可能如下所示：

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

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

便携版本是首选，但我也满足于仅限LaTeX的黑客攻击。

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添加标题中的换行符。

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

3 个答案: