MarkdownをWordのテンプレートを充てつつdockerのpandocでWordに変換する

2954 ワード
Pandoc Word Docker Markdown Markdown テキストリンク

設計書をMarkdownにしてGitで管理出来ないかという話が出てきたので、
環境構築及びMarkdownファイルにテンプレートを充てるまで実施してみる。

確認環境

  • Mac OS Mojave 10.14.3

前提

  • dockerがインストールされていること。

手順

サンプル用のMarkdownファイルを取得。

$ curl https://raw.githubusercontent.com/mitsuaki1229/Sample/master/Documents/ForPandockConversionFile/ForPandockConversionFile.md -o ForPandockConversionFile.md

変換時にレイアウトとして充てる無料のテンプレートを拝借し、解凍。

$ curl http://siland.jp/data/manual.zip -o manual.zip
$ docker run --rm -v `pwd`:/data ca54makske/ubuntu-unzip -Ocp932 ./manual.zip

拝借したテンプレートを充てつつMarkdownファイルからWordファイルを生成。

$ docker run -v `pwd`:/source jagregory/pandoc -f markdown -t docx README.md -o README.docx --reference-doc='業務マニュアル（テンプレート）/グリーン.docx'

結果

$ open README.docx

以前いた職場で設計書やマニュアルをMarkdownからpandocを利用してWordやPDFに変換していた際は、
ローカルのPCに環境を構築するのが大変だった記憶があるが、dockerだとすぐ出来て楽。
Wordのテンプレートのレイアウトと、Markdownのタグを上手く脳内マッピングすればいい感じに出来そうだけど、
良い感じの変換結果にしたい場合、Wordのレイアウトを作成する知識がある程度必要そう。

参考