More than 5 years have passed since last update.

Pandocのシンタックスハイライトのカラースキーム

Posted at 2019-07-30

はじめに

PandocでマークダウンをPDFに変換する際、--highlight-styleオプションでカラースキームを指定できる。指摘できるカラースキームは以下の通り。

pygments (デフォルト)
kate
monochrome
espresso
zenburn
haddock
tango

これらのカラースキームはそれぞれ同名のシンタックスハイライトエンジンに由来するらしいのだが、公式マニュアルには、それぞれどんな色になるか例示がないみたいなので、ここにまとめておく。

コードは以下に置いておく。

https://github.com/kaityo256/pandoc_highlight

MarkdownからPDFへ

とりあえず日常の文書をMarkdownで書いて、なんか印刷したりメールで送ったりする時にPDFにする、という人は多いと思う。僕はVSCodeでMarkdown Previewでプレビューしながら書いて、Markdown PDFでPDFに変換している。しかし、デフォルトでは数式が変換されない。例えばこんなマークダウンを書いたとする。

# Fizz Buzzを書いてみる

数式はこちら。

$$
\textrm{Print} \quad
\begin{cases}
\textrm{FizzBuzz!} & \textrm{if} \quad i \bmod 15 =0 \\
\textrm{Fizz!} & \textrm{if} \quad i \bmod 3 =0 \\
\textrm{Buzz!} & \textrm{if} \quad i \bmod 5 =0 \\
i & \textrm{otherwise}
\end{cases}
$$

Pythonによるコード例はこちら。

```py
for i in range(1, 100):
    if i % 3 is 0 and i % 5 is 0:
        print("Fizz Buzz!")
    elif i % 3 is 0:
        print("Fizz!")
    elif i % 5 is 0:
        print("Buzz!")
    else:
        print(i)
```

これを、VSCodeのMarkdown PDFで変換するとこんな感じに、数式を変換してくれない。

というわけで、pandocを使って変換してみる。ついでに余白の調整とかもしれみよう。

pandoc test.md -s -o default.pdf --latex-engine=lualatex -V documentclass=ltjarticle -V geometry:margin=1in

これで変換したPDFはこんな感じになる。

数式もいい感じで、シンタックスハイライトもあるのだが、コードブロックに背景色がないため、どこからどこまでかが分かりづらい。で、カラースキームを変えることにしたのだが、どれがどんな感じになるか探したら海外にそれっぽいブログがあるだけっぽかったので、Qiitaにまとめておきましょう、というのが本稿の趣旨である。

Pandocのカラースキーム

Pandocで変換する際に--highlight-style=pygmentsなどとするとカラースキームを指定できる。これで同じマークダウンファイルを異なるスキームでPDFに変換してみよう。

僕は古い人間なので、なんでもmakefileでやる癖があるのだが、とりあえずこんなのを書いてみる。

makefile

PDF=pygments.pdf kate.pdf monochrome.pdf espresso.pdf zenburn.pdf haddock.pdf tango.pdf
PANDOCOPT=--latex-engine=lualatex -V documentclass=ltjarticle -V geometry:margin=1in

all: $(PDF)

%.pdf: test.md
  pandoc $< -s -o $@ --highlight-style=$* $(PANDOCOPT)

.PHONY: clean

clean:
  rm -f $(PDF)