pandocを使って数式混じりのmarkdownをpdfに変換する方法（Mac）

LaTeX

Mac でのログ。変換対象のmarkdownはlatexによる数式が混じった文章である（github）。

  1. pandoc はbrewでインストールする

  2. Eisvogel のページからテンプレートをダウンロード https://github.com/Wandmalfarbe/pandoc-latex-template/releases

  3. テンプレートを解凍したフォルダにある eisvogel.latex を、~/.pandoc/templates フォルダ（ない場合は作る）に置く

  4. pdflatexが必要なので brew install basictex をする

  5. ここ を参考に、sudo tlmgr install 経由でたくさんパッケージをインストールする

  6. 以下のコマンドでmarkdown（例ではyour_text.md）をpdfに変換する（例では-o your_text.pdf）

pandoc your_text.md \
    -o your_text.pdf \
    --from markdown+tex_math_dollars \
    --template eisvogel \
    --syntax-highlighting=idiomatic

説明

  • --from markdown+tex_math_dollars: 入力形式を指定している。markdown に加えて +tex_math_dollars とすることで、$...$ (インライン) と $$...$$ (ディスプレイ) 形式の数式を正しく解釈するように Pandoc に指示

  • --template eisvogel: 見た目をいい感じにするテンプレート Eisvogel を使う

  • --syntax-highlighting=idiomatic: コードブロックを綺麗にハイライト表示する効果

注意

$$...$$ 形式で囲まれた箇所では、\begin{align} 〜 \end{align} や \begin{align*} 〜 \end{align*} だとpandocによる変換時にエラーが出る。\begin{aligned} 〜 \end{aligned} ならエラーは出ない。