PandocでMarkdownをODTに変換する

この記事は「LibreOffice Advent Calendar 2015」の11日目の記事として書かれたものです。
http://www.adventar.org/calendars/949

私はUbuntu Weekly Recipe 第389回　Ubuntuで使用できるMarkdownエディター ～Atom編～にも書いたとおり、以前はLibreOffice Writerで原稿を書いていましたが、今はMarkdownで書いています。より正確にはPHP Markdown Extraですが。派生版が多いところはMarkdownの辛いところです。
なぜPHP Markdown Extraかというと、脚注と表が書けるからです。とりあえずそれだけあれば何とか技術文書は書けます。

MarkdownをHTMLに変換する方法はいろいろとありますが、PDFに変換したい場合はいっぺんTeXを経由するのが定石です。が、正直TeXはよくわからないのでいっぺんODTに変換し、LibreOffice WriterでPDFにエクスポートするのがいいのではないかと考えました。
そもそもからして、表現力の関係で一発でPDFに変換することは稀で、いろいろと手を加えてからPDFに変換したいところです。であれば、余計に編集形式であるODTに変換することは合理性があるといえます。

HTMLの変換にもODFの変換にもPandocを使うのが圧倒的に便利です。ただ、あまりにも機能が多すぎて扱いにくいのもまた事実です。というわけで、MarkdownからPandocを使用してODFに変換する際に押さえておきたい勘所を記していきます。

○Pandocのバージョンは新しいものに
PandocはUbuntuのパッケージにもありますが、開発が活発に行われているので、リリースから個別にパッケージをダウンロードし、インストールするのがいいでしょう。とりあえず14.04ではインストールでき、動作することを確認しています。WindowsやOS Xでは使用していないので知りません。
新しいバージョンを使っていると、妙なバグを踏んで調査している時間を短縮できる可能性があります（体験談）。

○テンプレートを作りこむ
PandocはODTに変換する際、テンプレート(OTT)に流しこむことができます。というわけで、テンプレートを作りこめば作りこむほどスムーズにPDFに変換できるODTができることになるわけです。
テンプレートを一から作るのが面倒という場合は、日本語環境改善拡張機能のWriter4ja.ottをベースにするといいでしょう。

○画像のサイズを整える
WriterでA4縦のドキュメントを作る場合、画像のサイズは横640ドットぐらいにしておくのが無難です。
画像のサイズを変更する方法はいろいろありますが、私はmogrifyコマンドを使用しています。imagemagickパッケージに収録されています。Lanczosをサポートしているのはポイント高いです。
$ mogrify -quality 100 -filter Lanczos -resize 640x\> *.png

○画像のDPIを変更する
理由はよくわからないのですが、画像を96 DPIにしないとODTになった時に画像の比率が妙ちくりんなことになります。というわけで、これもやっぱりmogrifyコマンドで変換します。
$ mogrify -density 96 -units PixelsPerInch *.png

○いよいよPandoc先生の出番です
サンプルコマンドはこんな感じです。
$ pandoc -f markdown -t odt sample.md -o sample.odt --reference-odt=/PATH/TO/Writer4ja.ott
このコマンドを見ても、テンプレートの作りこみが大切であることがよくわかります。

あとはLibreOfficeで開き、必要な編集を加えてPDFにすれば完了です。
それではみなさま、よいMarkdown生活を（あれ？