これは「Pandoc Advent Calendar 2019」の8日目の記事です。
7日目は niszet0 さん、9日目は skyy_writing さんです。

ご存じの通り、Markdownにおいては「入力における段落¹内の改行は改行にならずに空白と解釈される」という規則があります²。例えば、次のようなMarkdown文書³があったとします。

All human beings are born free and equal
in dignity and rights.
They are endowed with reason and conscience
and should act towards one another
in a spirit of brotherhood.

これが表すのは次のような“改行のない1つの段落”です。もちろん、実際に出力される際には行長に応じて（「なりゆき」で）適宜改行が入ります。

All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.

このような「改行にならない改行」のことをMarkdownの用語⁴で「ソフト改行(soft line-break)」といいます。ソフト改行は“Markdownの思想”を実践する上で欠かせない大事な機能であることは疑いのないところでしょう⁵。ところが、日本語（のような単語間空白を用いない言語）のMarkdown文書においてソフト改行を使おうとすると「余計な空白が入る」という問題が発生します。

本記事では、この「余計な空白」問題のPandocでの解決方法について解説します。

※Pandocの2.x版を前提とします。（実際に使用しているのは2.8.0.1版。）

英語なMarkdownの場合

日本語文書の話の前に、まずは先に示した英語の文書について、Pandocでの変換の様子を調べてみましょう。

sample-en.md

All human beings are born free and equal
in dignity and rights.
They are endowed with reason and conscience
and should act towards one another
in a spirit of brotherhood.

ますはHTMLに変換してみます。

pandoc sample-en.md -o sample-en.html

以下のように改行が消えて1行で出力されました。HTMLでも入力中の改行はソフト改行になるはずですが、PandocのHTML変換のデフォルトでは、ソフト改行が空白文字に置き換えられるようです。

sample-en.html

<p>All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.</p>

もちろん、HTMLを実際に表示する際には「なりゆき」で改行が入ります⁶。

次に、同じMarkdown文書をLaTeX形式に変換してみます。

pandoc sample-en.md -o sample-en.tex

sample-en.tex

All human beings are born free and equal in dignity and rights. They are
endowed with reason and conscience and should act towards one another in
a spirit of brotherhood.

改行の入る位置が変わりました。もちろん、LaTeXでも改行はソフト改行なのでPDF変換した際の出力には影響せず、やはり出力は「なりゆき」で改行されます。

以上をまとめると、Pandocではソフト改行と空白文字を適宜相互に置き換えていることがわかりました。

日本語なMarkdownでHTMLするとアレ

それでは、いよいよ日本語の文書について考えてみましょう。

sample-ja1.md

すべての人間は、生まれながらにして
自由であり、かつ、尊厳と権利とについて平等である。
人間は、理性と良心を授けられてあり、
互いに同胞の精神をもって行動しなければならない。

これをHTMLに変換します。

pandoc sample-ja1.md -o sample-ja1.html

sample-ja1.html

<p>すべての人間は、生まれながらにして 自由であり、かつ、尊厳と権利とについて平等である。 人間は、理性と良心を授けられてあり、 互いに同胞の精神をもって行動しなければならない。</p>

※「にして␣自由で」「ある。␣人間は」「あり、␣互い」の箇所に空白がある。

先ほどと同様に1行で出力され、ソフト改行が空白文字に変換されました⁷。英語の場合はそれでよかったのですが、日本語ではこれらの空白が「余計」になってしまいます。

日本語なMarkdownでLaTeXしても結局アレ

今度はsample-ja1.mdをLaTeXに変換します。

pandoc sample-ja1.md -o sample-ja1.tex

出力のLaTeXソースは以下の通りです。入力と全く同じテキストになりました。

sample-ja1.tex

すべての人間は、生まれながらにして
自由であり、かつ、尊厳と権利とについて平等である。
人間は、理性と良心を授けられてあり、
互いに同胞の精神をもって行動しなければならない。

画像は「デフォルトのテンプレート＋LuaLaTeX＋bxjsarticleクラスのPandocモード」でPDFに変換した結果の出力。（以降、日本語文書のPDF変換には同じ設定を用いる。）

PDF変換のコマンド行（※実際は改行無しの1行）

pandoc sample-ja1.md -o sample-ja1.pdf --pdf-engine=lualatex
  -V documentclass=bxjsarticle -V classoption=pandoc

LaTeXでは⁸「行末に日本語の文字がある場合はソフト改行は空白にせずに無視する」という規則があるので、今の場合は（Markdown文書入力時の意図の通りに）ソフト改行は無視されて想定通りの出力が得られています。

ということは、LaTeXの場合は日本語でもソフト改行が自由に使えるのでしょうか？残念ながら必ずしもそうとはいえません。入力のMarkdown文書のソフト改行の位置を変えたもので試してみます。

sample-ja2.md

すべての人間は、生まれながらにして
自由であり、かつ、尊厳と権利とについて
平等である。
人間は、理性と良心を授けられてあり、
互いに同胞の精神をもって
行動しなければならない。

これをLaTeXに変換します。

pandoc sample-ja2.md -o sample-ja2.tex

結果は次の通りです。

sample-ja2.tex

すべての人間は、生まれながらにして
自由であり、かつ、尊厳と権利とについて 平等である。
人間は、理性と良心を授けられてあり、 互いに同胞の精神をもって
行動しなければならない。

※「ついて␣平等で」「あり、␣互い」の箇所に空白がある。

今度はソフト改行の一部が空白文字に変わってしまいました。やはり、Pandocは日本語文書の場合でもソフト改行と空白文字を適宜変換して出力ソースの行長を整えようとするようです⁹。LaTeXでも日本語文字の間にある空白文字はそのまま空白として扱われる¹⁰ため、今度は出力に「余計な空白」が生じてしまいます。

日本語なMarkdownで非アレにHTMLする方法

これまでにみた通り、“Markdownの思想”に則ってソフト改行を利用しようとすると、HTMLとLaTeXの場合でチョット事情は異なりますが、日本語文書に関しては「余計な空白」が出るというアレな結果になりました。幸いなことに、Pandocではこの問題に対処するための種々の設定が用意されています。

まずはHTMLへの変換について考えましょう。

“ignore_line_breaks”拡張：入力のソフト改行を無視する

HTML出力の場合、要するに「入力のソフト改行は空白」となります。しかし日本語文書の入力で意図しているのは「入力のソフト改行は無視される」のはずです。結局、Markdownの解析方法を変更する必要があるわけです。

Pandoc’s Markdownの拡張のignore_line_breaksを有効にすると、まさにその「入力のソフト改行は無視される」という規則が適用されます。

pandoc -f markdown+ignore_line_breaks sample-ja1.md -o sample-ja1i.html

※入力形式（-f）をデフォルトのmarkdownからmarkdown+ignore_line_breaks（ignore_line_breaksを有効にしたPandoc’s Markdown）に変更しています。

sample-ja1i.html

<p>すべての人間は、生まれながらにして自由であり、かつ、尊厳と権利とについて平等である。人間は、理性と良心を授けられてあり、互いに同胞の精神をもって行動しなければならない。</p>

「余計な空白」がなくなって、想定通りの結果が得られました。

ただし、この方法には問題があります。「入力のソフト改行は無視される」という規則はいつでも適用できるわけではありません。入力が英語の場合は空白が入らないと不適切ですし、たとえ日本語文書であっても、中に部分的に英語（などの欧文）が含まれている場合は、その箇所には空白が必要でしょう。

sample-ja3.md

世界人権宣言（Universal Declaration
of Human Rights）はすべての人民とすべての国が
達成すべき基本的人権についての宣言である。

この文書をignore_line_breaks付きでHTMLに変換すると次のようになります。本来Declaration␣ofであってほしいところが空白が欠けてしまいます。

<p>世界人権宣言（Universal Declarationof Human Rights）はすべての人民とすべての国が達成すべき基本的人権についての宣言である。</p>

“east_asian_line_breaks”拡張：入力のソフト改行を“いい感じ”に無視する

ignore_line_breaks拡張の欠点を解決したのがeast_asian_line_breaks拡張です。これを有効にすると、日本語文字¹¹どうしの間にあるソフト改行だけが無視されて、それ以外のソフト改行は通常通り処理される（HTML出力の場合は空白文字になる）ようになります。

先ほどの“英語混じり”の日本語文書sample-ja3.mdをこの拡張を有効にして変換してみましょう。

pandoc -f markdown+east_asian_line_breaks sample-ja3.md -o sample-ja3e.html

sample-ja3e.html

<p>世界人権宣言（Universal Declaration of Human Rights）はすべての人民とすべての国が達成すべき基本的人権についての宣言である。</p>

完璧な出力が得られました！

チョット補足

この節で紹介したMarkdown拡張を用いる方法は、HTML出力以外でも「そもそもソフト改行をサポートしない出力形式」（Word・textileなど）や「ソフト改行が必ず空白として解釈される出力形式」（reSTなど）でも同様に利用できます。
入力形式はMarkdownに限られます。ただし、east_asian_line_breaks拡張はPandoc’s Markdown（markdown）以外のMarkdown変種（commonmarkやmarkdown_strictやgfmなど）でも利用できます¹²。
east_asian_line_breaks拡張では「日本語文字と非日本語文字の間にあるソフト改行」は無視されません。そのような箇所に空白を入れたくない人¹³は、文書の入力において適宜改行位置を調整しましょう。

日本語なMarkdownで非アレにLaTeXする方法

east_asian_line_breaks拡張自体はLaTeX出力の場合にも利用できますが、LaTeXのようにそれ自身が「ソフト改行を無視する規則」をもつ出力形式を使う場合は、次の2つの過程が同時におきて複雑になってしまいます。

Pandocが自身の規則でソフト改行の一部を無視する。
LaTeXが自身の規則でソフト改行の一部を無視する。

特に、日本語LaTeXのソフト改行の規則を熟知している人から見ると、「Pandocの規則」に基づく処理は想定外の結果と捉えられることがあるでしょう。

例えば次のような例を考えます。

sample-ja4.md

世界人権宣言は
1948年12月10日に採択された。

LaTeXの規則としては「直前が日本語文字であるソフト改行は無視される」ことになるので、宣言はと1948年の間には空白文字は入らない¹⁴ことが期待されます。ところが、実際にPandocで変換した結果は次のようになります。

pandoc -f markdown+east_asian_line_breaks sample-ja4.md -o sample-ja4e.tex

sample-ja4e.tex

世界人権宣言は 1948年12月10日に採択された。

※east_asian_line_breaksの規則では宣言はと1948年の間のソフト改行は保持されます。そしてPandocが行長を整えるためにソフト改行を空白文字に置き換えるので、結局LaTeXの入力に空白が入ることになります。

そもそもここで問題を起こしているのは「Pandocがソフト改行と空白文字との間で相互変換を行う」ことであり、LaTeXの規則を知る人から見ると、一番好ましいのは「ソフト改行がそのままLaTeXのソフト改行として保持される」ことであるはずです。

`--wrap=perserve`：入力のソフト改行をLaTeXソース出力で保持する

Pandocの「ソフト改行と空白文字の相互変換」に関する挙動は--wrapオプションで制御できます¹⁵。

--wrapは引数をとるオプションです。デフォルトは--wrap=autoでこの場合は「行長を整えるためにソフト改行と空白文字との間で相互変換を行う」処理が有効になります。そして、--wrap=preserveを指定すると、相互変換が抑止されて「入力のソフト改行と空白文字は出力（のソース）中でもそのまま保持される、つまりソフト改行と空白文字として出力される」という動作になります。

先の例のsample-ja4.mdを--wrap=preserveを付けて変換してみましょう。

pandoc --wrap=preserve sample-ja4.md -o sample-ja4p.tex

※「Pandocがソフト改行を無視する」という動作はもはや不要であるため、east_asian_line_breaks拡張は指定しません。

sample-ja4p.tex

世界人権宣言は
1948年12月10日に採択された。

文字だけからなるMarkdown文書であるため結果的に入力と全く同じ出力となりました。「入力したそのまま」のソフト改行が反映されるので、LaTeXユーザが理解しやすい動作になっていることがわかります。

「日本語なMarkdownでLaTeXしても結局アレ」の節で失敗していたsample-ja2.mdも同様に変換してみましょう。容易に予想されるように、この場合も入力と出力は全く同じになります。

pandoc --wrap=preserve sample-ja2.md -o sample-ja2p.tex

sample-ja2p.tex

すべての人間は、生まれながらにして
自由であり、かつ、尊厳と権利とについて
平等である。
人間は、理性と良心を授けられてあり、
互いに同胞の精神をもって
行動しなければならない。