Pandocを使ったWord組版のはじめ方

Wordで組版をしていくにあたって、Wordのアプリケーション上で文章やサンプルコードを入力していくのは現実的ではありません。 見出しのスタイルを当てたり、シンタックスハイライトを手動で当てていくのはMarkdownになれた人間がやるべきことではありません。ツールにまかせるべきです。そこで利用するのがPandocというツールです。

はじめてのPandoc

Pandocとは？

Pandocはドキュメントの形式を変換するツールで、MarkdownやPDF、ePub、Wordなどの多くのフォーマットに対応しています。今回は、MarkdownからWordに変換する用途でPandocを利用します。

Pandoc - About pandoc

Pandocのインストール

Pandocは公式サイトからインストールします。

ターミナル（端末）から次のコマンドを入力して、バージョンが出力されたらインストールは成功です。

$ pandoc -v

Pandocの実行

適当なMarkdownファイルを用意して、今回はentry.mdという名前で保存します。

コマンドラインで以下のコマンドを実行しましょう。

pandoc entry.md -o result.docx

result.docxというワードファイルが生成されれば成功です。entry.mdに記述したマークダウンがWordファイルに変換されているはずです。

ただ、標準のテンプレートは少しダサく、そのまま印刷に回せるものではないと思います。Pandocにはカスタマイズしたテンプレートを利用する機能があるので、標準のテンプレートを次のコマンドで取り出します。

pandoc --print-default-data-file reference.docx > reference.docx

その後、スタイルを整えた後に、次のコマンドでカスタマイズしたテンプレートを利用します。

pandoc entry.md —reference-doc=custom-reference.docx -o result.docx

うまく動いていれば、カスタマイズしたテンプレートが適用できているはずです。

テンプレートに関しては、以下のポイントを意識作ると使いやすいテンプレートができます。

• スタイル（見出し、本文）に対して、装飾を当てていく
• スタイルの継承を利用する
• ショートコード（ページ、章の表示）を利用する

参考

• MS Wordで柱に章番号・テキストを表示する方法 - mottox2 blog
• docxファイルの中身を覗いてみよう - mottox2 blog

defaults.ymlの利用

設定が増えてくると、どんどん実行するオプションが増え長くなっていきます。これらのオプションはファイルから与えることも可能で「Default files 」と呼ばれています。

例えば、次のymlをdefaults.ymlとして保存し、次のコマンドを実行します。

from: markdown+hard_line_breaks
to: docx
output-file: result.docx
input-files:
- entry.md

reference-doc: custom-reference.docx

pandoc -d defaults.yml

このようにファイルに設定を落とすことで、コマンドの煩雑さも減り、管理がしやすくなります。

テンプレート

これらの設定を利用するためのテンプレートを用意したのでぜひお使いください。

mottox2/pandoc-word-starter: Pandoc template for docx

次のコマンドでWordファイルが生成されます。

pandoc -d defaults.yml