md2pdf.md

Markdownから資料向けPDFを作る

pandocというツールを使い、資料向けPDFを作る。

1. 必要パッケージのインストール

$ sudo apt-get install texlive-full pandoc

2. listingsの設定

listings-setup.texを配置する。
僕の環境では、~/.pandoc/listings-setup.texに配置。
pandocコマンド実行時にオプションで指定できる場所に置けばよい。

3. PDFの生成

$ pandoc sample.md \
> -V documentclass=ltjltxdoc \
> -V mainfont=Ricty \
> -V --listings -H ~/.pandoc/listings-setup.tex \
> --latex-engine=lualatex \
> -o sample.pdf

-V documentclass=ltjltxdocでは、
-V --listings -H ~/.pandoc/listings-setup.texで、listingsの使用と設定ファイルを指定する。
-V mainfont=Rictyで、使用するフォント名を指定する。
--latex-engine=lualatexで、
-o sample.pdfでは、出力ファイル名を指定する。
出力ファイルのフォーマットは拡張子から自動判別される。

その他のオプションやMarkdown記法については、
Pandoc ユーザーズガイド 日本語版を参照。

4. スタイルの崩れる、変換失敗するフォーマット等

見出し(h6のみ)が、何故か改行されずに出力される。
変換に失敗するわけではないので、とりあえず保留。

###### h6

コードブロックのインライン表示で日本語を使うと変換に失敗する。
※要検証、変換できる場合がある。
listingsを利用している通常のコードブロックでは、
luatexjaを利用しているので日本語の利用ができる。

``コードブロック``

水平線が端から端まで出力されない。
これも変換に失敗するわけではないので保留。

- - -
* * *